ListView.TopItem プロパティとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ListView.TopItem プロパティ

コントロールで最初に表示される項目を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property TopItem As
 ListViewItem

Visual Basic (使用法)

Dim instance As ListView
Dim value As ListViewItem

value = instance.TopItem

instance.TopItem = value

public ListViewItem TopItem { get; set;
 }

C++

public:
property ListViewItem^ TopItem {
    ListViewItem^ get ();
    void set (ListViewItem^ value);
}

/** @property */
public ListViewItem get_TopItem ()

/** @property */
public void set_TopItem (ListViewItem value)

JScript

public function get TopItem
 () : ListViewItem

public function set TopItem
 (value : ListViewItem)

プロパティ値
コントロールで最初に表示される項目を表す ListViewItem。

例外

例外の種類	条件
InvalidOperationException	View プロパティは、LargeIcon、SmallIcon、または Tile に設定されます。

解説

初期状態では、インデックス位置 0 の項目が ListView コントロールの一番上に示されます。ListView コントロールの内容がスクロールされると、別の項目がコントロールの一番上に来る場合があります。このプロパティを使用して、ListView コントロールの一番上に表示される項目を指定または確認できます。TopItem プロパティの値は、常に保持されるとは限りません。保持されるかどうかは、一番上に表示される項目のリストビューでの位置によって異なります。

ListView コントロールにいつも表示される項目の数は、リストビューの高さ、およびリストビューに配置される項目のサイズによって異なります。リストビューの高さを超えた場合、項目は複数のページにわたって表示され、ユーザーがそれらをスクロールできます。TopItem プロパティを ListView の最後のページ内の項目に設定すると、その項目は自動的にスクロールされてビューに表示されますが、TopItem は、実際の最後のページの一番上の項目に設定されます。

特定の項目が確実にコントロールの表示領域に表示されるようにする (必ずしも一番上である必要はない) には、EnsureVisible メソッドを使用します。

メモ
Scrollable プロパティ値が false の場合は、このプロパティを設定しても影響はありません。バージョン 2.0 より前の .NET Framework では、このプロパティの設定はサポートされません。

メモ

Scrollable プロパティ値が false の場合は、このプロパティを設定しても影響はありません。

バージョン 2.0 より前の .NET Framework では、このプロパティの設定はサポートされません。

使用例

TopItem プロパティおよび ListViewItem.ListViewSubItem.ResetStyle メソッドを使用して、ListViewItem オブジェクトのサブ項目のスタイルをリセットするコード例を次に示します。この例を実行するには、次のコードを Button1 という名前のボタンが配置されているフォームに貼り付けて、フォームのコンストラクタまたは Load イベントハンドラで InitializeListView メソッドを呼び出します。

Visual Basic

' Declare the Listview object.
Friend WithEvents myListView As
 System.Windows.Forms.ListView

' Initialize the ListView object with subitems of a different
' style than the default styles for the ListView.
Private Sub InitializeListView()

    ' Set the Location, View and Width properties for the 
    ' ListView object. 
    myListView = New ListView
    With (myListView)
        .Location = New System.Drawing.Point(20, 20)

        ' The View property must be set to Details for the 
        ' subitems to be visible.
        .View = View.Details
        .Width = 250
    End With

    ' Each SubItem object requires a column, so add three columns.
    Me.myListView.Columns.Add("Key",
 50, HorizontalAlignment.Left)
    Me.myListView.Columns.Add("A",
 100, HorizontalAlignment.Left)
    Me.myListView.Columns.Add("B",
 100, HorizontalAlignment.Left)

    ' Add a ListItem object to the ListView.
    Dim entryListItem As ListViewItem = myListView.Items.Add("Items")

    ' Set UseItemStyleForSubItems property to false to change 
    ' look of subitems.
    entryListItem.UseItemStyleForSubItems = False

    ' Add the expense subitem.
    Dim expenseItem As ListViewItem.ListViewSubItem
 = _
        entryListItem.SubItems.Add("Expense")

    ' Change the expenseItem object's color and font.
    expenseItem.ForeColor = System.Drawing.Color.Red
    expenseItem.Font = New System.Drawing.Font _
        ("Arial", 10, System.Drawing.FontStyle.Italic)

    ' Add a subitem called revenueItem 
    Dim revenueItem As ListViewItem.ListViewSubItem
 = _
        entryListItem.SubItems.Add("Revenue")

    ' Change the revenueItem object's color and font.
    revenueItem.ForeColor = System.Drawing.Color.Blue
    revenueItem.Font = New System.Drawing.Font _
        ("Times New Roman", 10, System.Drawing.FontStyle.Bold)

    ' Add the ListView to the form.
    Me.Controls.Add(Me.myListView)
End Sub

Private Sub Button1_Click(ByVal
 sender As System.Object, ByVal e As
 System.EventArgs) Handles Button1.Click

    ' Use the ListView.TopItem property to access the SubItems
    ' and then reset their appearance.
    myListView.TopItem.SubItems(1).ResetStyle()
    myListView.TopItem.SubItems(2).ResetStyle()
End Sub

// Declare the Listview object.
internal System.Windows.Forms.ListView myListView;

// Initialize the ListView object with subitems of a different
// style than the default styles for the ListView.
private void InitializeListView()
{

    // Set the Location, View and Width properties for the 
    // ListView object. 
    myListView = new ListView();
    myListView.Location = new System.Drawing.Point(20, 20);
    myListView.Width = 250;

    // The View property must be set to Details for the 
    // subitems to be visible.
    myListView.View = View.Details;
    
    // Each SubItem object requires a column, so add three columns.
    this.myListView.Columns.Add("Key", 50, HorizontalAlignment.Left);
    this.myListView.Columns.Add("A", 100, HorizontalAlignment.Left);
    this.myListView.Columns.Add("B", 100, HorizontalAlignment.Left);

    // Add a ListItem object to the ListView.
    ListViewItem entryListItem = myListView.Items.Add("Items");

    // Set UseItemStyleForSubItems property to false to change 
    // look of subitems.
    entryListItem.UseItemStyleForSubItems = false;

    // Add the expense subitem.
    ListViewItem.ListViewSubItem expenseItem = 
        entryListItem.SubItems.Add("Expense");

    // Change the expenseItem object's color and font.
    expenseItem.ForeColor = System.Drawing.Color.Red;
    expenseItem.Font = new System.Drawing.Font(
        "Arial", 10, System.Drawing.FontStyle.Italic);

    // Add a subitem called revenueItem 
    ListViewItem.ListViewSubItem revenueItem = 
        entryListItem.SubItems.Add("Revenue");

    // Change the revenueItem object's color and font.
    revenueItem.ForeColor = System.Drawing.Color.Blue;
    revenueItem.Font = new System.Drawing.Font(
        "Times New Roman", 10, System.Drawing.FontStyle.Bold);

    // Add the ListView to the form.
    this.Controls.Add(this.myListView);
}

private void Button1_Click(System.Object sender,
 System.EventArgs e)
{

    // Use the ListView.TopItem property to access the SubItems
    // and then reset their appearance.
    myListView.TopItem.SubItems[1].ResetStyle();
    myListView.TopItem.SubItems[2].ResetStyle();
}

C++

internal:
   // Declare the Listview object.
   System::Windows::Forms::ListView^ myListView;

private:

   // Initialize the ListView object with subitems of a different
   // style than the default styles for the ListView.
   void InitializeListView()
   {
      // Set the Location, View and Width properties for the 
      // ListView object. 
      myListView = gcnew ListView;
      myListView->Location = System::Drawing::Point( 20, 20 );
      myListView->Width = 250;
      
      // The View property must be set to Details for the 
      // subitems to be visible.
      myListView->View = View::Details;
      
      // Each SubItem object requires a column, so add three columns.
      this->myListView->Columns->Add( "Key",
 50, HorizontalAlignment::Left );
      this->myListView->Columns->Add( "A",
 100, HorizontalAlignment::Left );
      this->myListView->Columns->Add( "B",
 100, HorizontalAlignment::Left );
      
      // Add a ListItem object to the ListView.
      ListViewItem^ entryListItem = myListView->Items->Add( "Items"
 );
      
      // Set UseItemStyleForSubItems property to false to change 
      // look of subitems.
      entryListItem->UseItemStyleForSubItems = false;
      
      // Add the expense subitem.
      ListViewItem::ListViewSubItem ^ expenseItem = entryListItem->SubItems->Add(
 "Expense" );
      
      // Change the expenseItem object's color and font.
      expenseItem->ForeColor = System::Drawing::Color::Red;
      expenseItem->Font = gcnew System::Drawing::Font( "Arial",10,System::Drawing::FontStyle::Italic
 );
      
      // Add a subitem called revenueItem 
      ListViewItem::ListViewSubItem ^ revenueItem = entryListItem->SubItems->Add(
 "Revenue" );
      
      // Change the revenueItem object's color and font.
      revenueItem->ForeColor = System::Drawing::Color::Blue;
      revenueItem->Font = gcnew System::Drawing::Font( "Times New Roman",10,System::Drawing::FontStyle::Bold
 );
      
      // Add the ListView to the form.
      this->Controls->Add( this->myListView
 );
   }

   void Button1_Click( System::Object^ /*sender*/, System::EventArgs^
 /*e*/ )
   {
      // Use the ListView.TopItem property to access the SubItems
      // and then reset their appearance.
      myListView->TopItem->SubItems[ 1 ]->ResetStyle();
      myListView->TopItem->SubItems[ 2 ]->ResetStyle();
   }

// Declare the Listview object.
System.Windows.Forms.ListView myListView;

// Initialize the ListView object with subitems of a different
// style than the default styles for the ListView.
private void InitializeListView()
{
    // Set the Location, View and Width properties for the 
    // ListView object. 
    myListView = new ListView();
    myListView.set_Location(new System.Drawing.Point(20, 20));
    myListView.set_Width(250);
    // The View property must be set to Details for the 
    // subitems to be visible.
    myListView.set_View(View.Details);
    // Each SubItem object requires a column, so add three columns.
    this.myListView.get_Columns().Add("Key", 50, HorizontalAlignment.Left);
    this.myListView.get_Columns().Add("A", 100, HorizontalAlignment.Left);
    this.myListView.get_Columns().Add("B", 100, HorizontalAlignment.Left);
    // Add a ListItem object to the ListView.
    ListViewItem entryListItem = myListView.get_Items().Add("Items");
    // Set UseItemStyleForSubItems property to false to change 
    // look of subitems.
    entryListItem.set_UseItemStyleForSubItems(false);
    // Add the expense subitem.
    ListViewItem.ListViewSubItem expenseItem =
        entryListItem.get_SubItems().Add("Expense");
    // Change the expenseItem object's color and font.
    expenseItem.set_ForeColor(System.Drawing.Color.get_Red());
    expenseItem.set_Font(new System.Drawing.Font("Arial",
 10,
        System.Drawing.FontStyle.Italic));
    // Add a subitem called revenueItem 
    ListViewItem.ListViewSubItem revenueItem =
        entryListItem.get_SubItems().Add("Revenue");
    // Change the revenueItem object's color and font.
    revenueItem.set_ForeColor(System.Drawing.Color.get_Blue());
    revenueItem.set_Font(new System.Drawing.Font("Times New
 Roman", 10,
        System.Drawing.FontStyle.Bold));
    // Add the ListView to the form.
    this.get_Controls().Add(this.myListView);
} //InitializeListView

private void button1_Click(Object sender, System.EventArgs
 e)
{
    // Use the ListView.TopItem property to access the SubItems
    // and then reset their appearance.
    myListView.get_TopItem().get_SubItems().get_Item(1).ResetStyle();
    myListView.get_TopItem().get_SubItems().get_Item(2).ResetStyle();
} //button1_Click

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ListView クラス
ListView メンバ
System.Windows.Forms 名前空間
ListViewItem
EnsureVisible

このページでは「.NET Framework クラスライブラリリファレンス」からListView.TopItem プロパティを検索した結果を表示しています。
Weblioに収録されているすべての辞書からListView.TopItem プロパティを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からListView.TopItem プロパティを検索

>> 「ListView.TopItem プロパティ」を含む用語の索引
ListView.TopItem プロパティのページへのリンク

ListView.TopItem プロパティとは？わかりやすく解説

ListView.TopItem プロパティ

「ListView.TopItem プロパティ」の関連用語


	© 2025 Microsoft.All rights reserved.

ListView.TopItem プロパティとは？ わかりやすく解説

ListView.TopItem プロパティ

急上昇のことば

「ListView.TopItem プロパティ」の関連用語

ListView.TopItem プロパティとは？わかりやすく解説