ListViewItem.ListViewSubItem クラス
ListViewItem のサブ項目を表します。
名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文
解説
使用例
継承階層
スレッド セーフ
プラットフォーム
バージョン情報
参照
アセンブリ: 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.Object
System.Windows.Forms.ListViewItem.ListViewSubItem
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 クラスのページへのリンク
