ListViewItem.ListViewSubItem クラス
ListViewItem のサブ項目を表します。
この型のすべてのメンバの一覧については、ListViewItem.ListViewSubItem メンバ を参照してください。
System.Object
System.Windows.Forms.ListViewItem.ListViewSubItem
<Serializable>
Public Class ListViewItem.ListViewSubItem
[C#]
[Serializable]
public class ListViewItem.ListViewSubItem
[C++]
[Serializable]
public __gc class ListViewItem.ListViewSubItem
[JScript]
public
Serializable
class ListViewItem.ListViewSubItem
スレッドセーフ
この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。
解説
ListView コントロールは、 ListViewItem クラスによって定義された項目のリストを表示します。各 ListViewItem は、 ListViewItem.ListViewSubItem クラスによって定義されたサブ項目オブジェクトを格納できます。サブ項目は、 ListView コントロールの View プロパティが View.Details に設定されているときに表示されます。通常、サブ項目には親項目に関連する情報が含まれています。たとえば、 ListView コントロールが受注を表す項目を表示する場合は、各項目で受注番号を表示できます。各項目にサブ項目を追加して、受注した製品、受注品目の数量、受注品目の合計額などの情報を表示できます。 ListViewItem オブジェクトとは異なり、 ListViewItem.ListViewSubItem オブジェクトはユーザーが直接編集できません。 ListView コントロールの LabelEdit プロパティが true に設定されている場合、ユーザーは ListViewItem オブジェクトを編集できます。
サブ項目はユーザーによって直接編集されず、イメージも表示しないため、プロパティは、 ListView コントロールでサブ項目が表示されるときに、サブ項目のテキストのスタイルに影響を与えるプロパティに限定されます。サブ項目を含む ListView の UseItemStyleForSubItems プロパティが false に設定されている場合は、 Font 、 BackColor 、 ForeColor の各プロパティを使用して、テキストの表示に適用されるスタイルを変更できます。通常、項目とサブ項目のスタイルは ListView コントロールで同じですが、特定の ListViewItem.ListViewSubItem のスタイルを変更して強調表示する場合は、異なる表示をする項目に対してこれらのプロパティを使用できます。
使用例
[Visual Basic, C#, C++] 3 つの ListViewItem オブジェクトが指定され、各項目に 3 つずつ ListViewItem.ListViewSubItem オブジェクトが指定されている ListView コントロールを作成する例を次に示します。この例は、 ColumnHeader オブジェクトを作成して、詳細ビューにサブ項目を表示することもできます。 ListViewItem オブジェクトのイメージを提供するコード例では、2 つの ImageList オブジェクトも作成されています。これらの ImageList オブジェクトは、 LargeImageList プロパティおよび SmallImageList プロパティに追加されます。この例では、 ListView コントロールを作成中に、次のプロパティを使用します。
[Visual Basic, C#, C++] この例は、コードを 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
[C#]
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);
}
[C++]
private:
void CreateMyListView() {
// Create a new ListView control.
ListView* listView1 = new 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 = new ListViewItem(S"item1", 0);
// Place a check mark next to the item.
item1->Checked = true;
item1->SubItems->Add(S"1");
item1->SubItems->Add(S"2");
item1->SubItems->Add(S"3");
ListViewItem* item2 = new ListViewItem(S"item2", 1);
item2->SubItems->Add(S"4");
item2->SubItems->Add(S"5");
item2->SubItems->Add(S"6");
ListViewItem* item3 = new ListViewItem(S"item3", 0);
// Place a check mark next to the item.
item3->Checked = true;
item3->SubItems->Add(S"7");
item3->SubItems->Add(S"8");
item3->SubItems->Add(S"9");
// Create columns for the items and subitems.
listView1->Columns->Add(S"Item Column", -2, HorizontalAlignment::Left);
listView1->Columns->Add(S"Column 2", -2, HorizontalAlignment::Left);
listView1->Columns->Add(S"Column 3", -2, HorizontalAlignment::Left);
listView1->Columns->Add(S"Column 4", -2, HorizontalAlignment::Center);
//Add the items to the ListView.
ListViewItem* temp1 [] = {item1, item2, item3};
listView1->Items->AddRange(temp1);
// Create two ImageList objects.
ImageList* imageListSmall = new ImageList();
ImageList* imageListLarge = new ImageList();
// Initialize the ImageList objects with bitmaps.
imageListSmall->Images->Add(Bitmap::FromFile(S"C:\\MySmallImage1.bmp"));
imageListSmall->Images->Add(Bitmap::FromFile(S"C:\\MySmallImage2.bmp"));
imageListLarge->Images->Add(Bitmap::FromFile(S"C:\\MyLargeImage1.bmp"));
imageListLarge->Images->Add(Bitmap::FromFile(S"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);
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン .gif)
をクリックします。
必要条件
名前空間: System.Windows.Forms
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET
アセンブリ: System.Windows.Forms (System.Windows.Forms.dll 内)
参照
ListViewItem.ListViewSubItem メンバ | System.Windows.Forms 名前空間 | ListViewItem