ListViewItem.ListViewSubItem クラス
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)


ListView コントロールは、ListViewItem クラスによって定義された項目のリストを表示します。各 ListViewItem は、ListViewItem.ListViewSubItem クラスによって定義されたサブ項目オブジェクトを格納できます。サブ項目は、ListView コントロールの View プロパティが Details に設定されているときに表示されます。通常、サブ項目には親項目に関連する情報が含まれています。たとえば、ListView コントロールが受注を表す項目を表示する場合は、各項目で受注番号を表示できます。各項目にサブ項目を追加して、受注した製品、受注品目の数量、受注品目の合計額などの情報を表示できます。ListViewItem オブジェクトとは異なり、ListViewItem.ListViewSubItem オブジェクトはユーザーが直接編集できません。ListView コントロールの LabelEdit プロパティが true に設定されている場合、ユーザーは ListViewItem オブジェクトを編集できます。
サブ項目はユーザーによって直接編集されず、イメージも表示しないため、プロパティは、ListView コントロールでサブ項目が表示されるときに、サブ項目のテキストのスタイルに影響を与えるプロパティに限定されます。サブ項目を含む ListView の UseItemStyleForSubItems プロパティが false に設定されている場合は、Font、BackColor、ForeColor の各プロパティを使用して、テキストの表示に適用されるスタイルを変更できます。通常、項目とサブ項目のスタイルは ListView コントロールで同じですが、特定の ListViewItem.ListViewSubItem のスタイルを変更して強調表示する場合は、異なる表示をする項目に対してこれらのプロパティを使用できます。

3 つの ListViewItem オブジェクトが指定され、各項目に 3 つずつ ListViewItem.ListViewSubItem オブジェクトが指定されている ListView コントロールを作成するコード例を次に示します。この例は、ColumnHeader オブジェクトを作成して、詳細ビューにサブ項目を表示することもできます。ListViewItem オブジェクトのイメージを提供するコード例では、2 つの ImageList オブジェクトも作成されています。これらの ImageList オブジェクトは、LargeImageList プロパティおよび SmallImageList プロパティに追加されます。この例では、ListView コントロールを作成中に、次のプロパティを使用します。
このコードを Form に追加し、この例で作成されているメソッドを、フォームのコンストラクタまたはフォーム上のその他のメソッドから呼び出す必要があります。またこの例では、MySmallImage1、MySmallImage2、MyLargeImage1、MyLargeImage2 という名前の各イメージが C ドライブのルート ディレクトリに保存されている必要があります。
Private Sub CreateMyListView() ' Create a new ListView control. Dim listView1 As New ListView() listView1.Bounds = New Rectangle(New Point(10, 10), New Size(300, 200)) ' Set the view to show details. listView1.View = View.Details ' Allow the user to edit item text. listView1.LabelEdit = True ' Allow the user to rearrange columns. listView1.AllowColumnReorder = True ' Display check boxes. listView1.CheckBoxes = True ' Select the item and subitems when selection is made. listView1.FullRowSelect = True ' Display grid lines. listView1.GridLines = True ' Sort the items in the list in ascending order. listView1.Sorting = SortOrder.Ascending ' Create three items and three sets of subitems for each item. Dim item1 As New ListViewItem("item1", 0) ' Place a check mark next to the item. item1.Checked = True item1.SubItems.Add("1") item1.SubItems.Add("2") item1.SubItems.Add("3") Dim item2 As New ListViewItem("item2", 1) item2.SubItems.Add("4") item2.SubItems.Add("5") item2.SubItems.Add("6") Dim item3 As New ListViewItem("item3", 0) ' Place a check mark next to the item. item3.Checked = True item3.SubItems.Add("7") item3.SubItems.Add("8") item3.SubItems.Add("9") ' Create columns for the items and subitems. listView1.Columns.Add("Item Column", -2, HorizontalAlignment.Left) listView1.Columns.Add("Column 2", -2, HorizontalAlignment.Left) listView1.Columns.Add("Column 3", -2, HorizontalAlignment.Left) listView1.Columns.Add("Column 4", -2, HorizontalAlignment.Center) 'Add the items to the ListView. listView1.Items.AddRange(New ListViewItem() {item1, item2, item3}) ' Create two ImageList objects. Dim imageListSmall As New ImageList() Dim imageListLarge As New ImageList() ' Initialize the ImageList objects with bitmaps. imageListSmall.Images.Add(Bitmap.FromFile("C:\MySmallImage1.bmp")) imageListSmall.Images.Add(Bitmap.FromFile("C:\MySmallImage2.bmp")) imageListLarge.Images.Add(Bitmap.FromFile("C:\MyLargeImage1.bmp")) imageListLarge.Images.Add(Bitmap.FromFile("C:\MyLargeImage2.bmp")) 'Assign the ImageList objects to the ListView. listView1.LargeImageList = imageListLarge listView1.SmallImageList = imageListSmall ' Add the ListView to the control collection. Me.Controls.Add(listView1) End Sub 'CreateMyListView
private void CreateMyListView() { // Create a new ListView control. ListView listView1 = new ListView(); listView1.Bounds = new Rectangle(new Point(10,10), new Size(300,200)); // Set the view to show details. listView1.View = View.Details; // Allow the user to edit item text. listView1.LabelEdit = true; // Allow the user to rearrange columns. listView1.AllowColumnReorder = true; // Display check boxes. listView1.CheckBoxes = true; // Select the item and subitems when selection is made. listView1.FullRowSelect = true; // Display grid lines. listView1.GridLines = true; // Sort the items in the list in ascending order. listView1.Sorting = SortOrder.Ascending; // Create three items and three sets of subitems for each item. ListViewItem item1 = new ListViewItem("item1",0); // Place a check mark next to the item. item1.Checked = true; item1.SubItems.Add("1"); item1.SubItems.Add("2"); item1.SubItems.Add("3"); ListViewItem item2 = new ListViewItem("item2",1); item2.SubItems.Add("4"); item2.SubItems.Add("5"); item2.SubItems.Add("6"); ListViewItem item3 = new ListViewItem("item3",0); // Place a check mark next to the item. item3.Checked = true; item3.SubItems.Add("7"); item3.SubItems.Add("8"); item3.SubItems.Add("9"); // Create columns for the items and subitems. listView1.Columns.Add("Item Column", -2, HorizontalAlignment.Left); listView1.Columns.Add("Column 2", -2, HorizontalAlignment.Left); listView1.Columns.Add("Column 3", -2, HorizontalAlignment.Left); listView1.Columns.Add("Column 4", -2, HorizontalAlignment.Center); //Add the items to the ListView. listView1.Items.AddRange(new ListViewItem[]{item1 ,item2,item3}); // Create two ImageList objects. ImageList imageListSmall = new ImageList(); ImageList imageListLarge = new ImageList(); // Initialize the ImageList objects with bitmaps. imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage1.bmp")); imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage2.bmp")); imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage1.bmp")); imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage2.bmp")); //Assign the ImageList objects to the ListView. listView1.LargeImageList = imageListLarge; listView1.SmallImageList = imageListSmall; // Add the ListView to the control collection. this.Controls.Add(listView1); }
private: void CreateMyListView() { // Create a new ListView control. ListView^ listView1 = gcnew ListView; listView1->Bounds = Rectangle(Point(10,10),System::Drawing::Size( 300, 200 )); // Set the view to show details. listView1->View = View::Details; // Allow the user to edit item text. listView1->LabelEdit = true; // Allow the user to rearrange columns. listView1->AllowColumnReorder = true; // Display check boxes. listView1->CheckBoxes = true; // Select the item and subitems when selection is made. listView1->FullRowSelect = true; // Display grid lines. listView1->GridLines = true; // Sort the items in the list in ascending order. listView1->Sorting = SortOrder::Ascending; // Create three items and three sets of subitems for each item. ListViewItem^ item1 = gcnew ListViewItem( "item1",0 ); // Place a check mark next to the item. item1->Checked = true; item1->SubItems->Add( "1" ); item1->SubItems->Add( "2" ); item1->SubItems->Add( "3" ); ListViewItem^ item2 = gcnew ListViewItem( "item2",1 ); item2->SubItems->Add( "4" ); item2->SubItems->Add( "5" ); item2->SubItems->Add( "6" ); ListViewItem^ item3 = gcnew ListViewItem( "item3",0 ); // Place a check mark next to the item. item3->Checked = true; item3->SubItems->Add( "7" ); item3->SubItems->Add( "8" ); item3->SubItems->Add( "9" ); // Create columns for the items and subitems. listView1->Columns->Add( "Item Column", -2, HorizontalAlignment::Left ); listView1->Columns->Add( "Column 2", -2, HorizontalAlignment::Left ); listView1->Columns->Add( "Column 3", -2, HorizontalAlignment::Left ); listView1->Columns->Add( "Column 4", -2, HorizontalAlignment::Center ); //Add the items to the ListView. array<ListViewItem^>^temp1 = {item1,item2,item3}; listView1->Items->AddRange( temp1 ); // Create two ImageList objects. ImageList^ imageListSmall = gcnew ImageList; ImageList^ imageListLarge = gcnew ImageList; // Initialize the ImageList objects with bitmaps. imageListSmall->Images->Add( Bitmap::FromFile( "C:\\MySmallImage1.bmp" ) ); imageListSmall->Images->Add( Bitmap::FromFile( "C:\\MySmallImage2.bmp" ) ); imageListLarge->Images->Add( Bitmap::FromFile( "C:\\MyLargeImage1.bmp" ) ); imageListLarge->Images->Add( Bitmap::FromFile( "C:\\MyLargeImage2.bmp" ) ); //Assign the ImageList objects to the ListView. listView1->LargeImageList = imageListLarge; listView1->SmallImageList = imageListSmall; // Add the ListView to the control collection. this->Controls->Add( listView1 ); }
private void CreateMyListView() { // Create a new ListView control. ListView listView1 = new ListView(); listView1.set_Bounds(new Rectangle(new Point(10, 10), new Size(300, 200))); // Set the view to show details. listView1.set_View(View.Details); // Allow the user to edit item text. listView1.set_LabelEdit(true); // Allow the user to rearrange columns. listView1.set_AllowColumnReorder(true); // Display check boxes. listView1.set_CheckBoxes(true); // Select the item and subitems when selection is made. listView1.set_FullRowSelect(true); // Display grid lines. listView1.set_GridLines(true); // Sort the items in the list in ascending order. listView1.set_Sorting(SortOrder.Ascending); // Create three items and three sets of subitems for each item. ListViewItem item1 = new ListViewItem("item1", 0); // Place a check mark next to the item. item1.set_Checked(true); item1.get_SubItems().Add("1"); item1.get_SubItems().Add("2"); item1.get_SubItems().Add("3"); ListViewItem item2 = new ListViewItem("item2", 1); item2.get_SubItems().Add("4"); item2.get_SubItems().Add("5"); item2.get_SubItems().Add("6"); ListViewItem item3 = new ListViewItem("item3", 0); // Place a check mark next to the item. item3.set_Checked(true); item3.get_SubItems().Add("7"); item3.get_SubItems().Add("8"); item3.get_SubItems().Add("9"); // Create columns for the items and subitems. listView1.get_Columns().Add("Item Column", -2, HorizontalAlignment.Left); listView1.get_Columns().Add("Column 2", -2, HorizontalAlignment.Left); listView1.get_Columns().Add("Column 3", -2, HorizontalAlignment.Left); listView1.get_Columns().Add("Column 4", -2, HorizontalAlignment.Center); //Add the items to the ListView. listView1.get_Items().AddRange(new ListViewItem[] { item1, item2, item3 }); // Create two ImageList objects. ImageList imageListSmall = new ImageList(); ImageList imageListLarge = new ImageList(); // Initialize the ImageList objects with bitmaps. imageListSmall.get_Images().Add(Bitmap.FromFile( "C:\\MySmallImage1.bmp")); imageListSmall.get_Images().Add(Bitmap.FromFile( "C:\\MySmallImage2.bmp")); imageListLarge.get_Images().Add(Bitmap.FromFile( "C:\\MyLargeImage1.bmp")); imageListLarge.get_Images().Add(Bitmap.FromFile( "C:\\MyLargeImage2.bmp")); //Assign the ImageList objects to the ListView. listView1.set_LargeImageList(imageListLarge); listView1.set_SmallImageList(imageListSmall); // Add the ListView to the control collection. this.get_Controls().Add(listView1); } //CreateMyListView

System.Windows.Forms.ListViewItem.ListViewSubItem


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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


ListViewItem.ListViewSubItem コンストラクタ ()
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)


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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


ListViewItem.ListViewSubItem コンストラクタ (ListViewItem, String, Color, Color, Font)
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)

Public Sub New ( _ owner As ListViewItem, _ text As String, _ foreColor As Color, _ backColor As Color, _ font As Font _ )
Dim owner As ListViewItem Dim text As String Dim foreColor As Color Dim backColor As Color Dim font As Font Dim instance As New ListViewSubItem(owner, text, foreColor, backColor, font)
public ListViewSubItem ( ListViewItem owner, string text, Color foreColor, Color backColor, Font font )
public: ListViewSubItem ( ListViewItem^ owner, String^ text, Color foreColor, Color backColor, Font^ font )
public ListViewSubItem ( ListViewItem owner, String text, Color foreColor, Color backColor, Font font )
public function ListViewSubItem ( owner : ListViewItem, text : String, foreColor : Color, backColor : Color, font : Font )

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


ListViewItem.ListViewSubItem コンストラクタ

名前 | 説明 |
---|---|
ListViewItem.ListViewSubItem () | ListViewItem.ListViewSubItem クラスの新しいインスタンスを既定値で初期化します。 .NET Compact Framework によってサポートされています。 |
ListViewItem.ListViewSubItem (ListViewItem, String) | ListViewItem.ListViewSubItem クラスの新しいインスタンスを、指定したオーナーとテキストを使用して初期化します。 |
ListViewItem.ListViewSubItem (ListViewItem, String, Color, Color, Font) | ListViewItem.ListViewSubItem クラスの新しいインスタンスを、指定したオーナー、テキスト、前景色、背景色、およびフォント値を使用して初期化します。 |

ListViewItem.ListViewSubItem コンストラクタ (ListViewItem, String)
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)


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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


ListViewItem.ListViewSubItem プロパティ
ListViewItem.ListViewSubItem メソッド

名前 | 説明 | |
---|---|---|
![]() | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
![]() | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
![]() | GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
![]() | ResetStyle | サブ項目に適用されるスタイルをリセットします。 |
![]() | ToString | オーバーライドされます。 |

名前 | 説明 | |
---|---|---|
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |

ListViewItem.ListViewSubItem メンバ
ListViewItem.ListViewSubItem データ型で公開されるメンバを以下の表に示します。



名前 | 説明 | |
---|---|---|
![]() | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) |
![]() | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
![]() | GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
![]() | ResetStyle | サブ項目に適用されるスタイルをリセットします。 |
![]() | ToString | オーバーライドされます。 |

名前 | 説明 | |
---|---|---|
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |

- ListViewItem.ListViewSubItemのページへのリンク