ListViewItem.ListViewSubItemCollection.Add メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
サブ項目のコレクションにサブ項目を追加します。
オーバーロード
| 名前 | 説明 |
|---|---|
| Add(String) |
指定したテキストを持つサブ項目をコレクションに追加します。 |
| Add(ListViewItem+ListViewSubItem) |
コレクションに既存の ListViewItem.ListViewSubItem を追加します。 |
| Add(String, Color, Color, Font) |
指定したテキスト、前景色、背景色、およびフォント設定を持つサブ項目をコレクションに追加します。 |
Add(String)
指定したテキストを持つサブ項目をコレクションに追加します。
public:
System::Windows::Forms::ListViewItem::ListViewSubItem ^ Add(System::String ^ text);public System.Windows.Forms.ListViewItem.ListViewSubItem Add(string text);public System.Windows.Forms.ListViewItem.ListViewSubItem Add(string? text);member this.Add : string -> System.Windows.Forms.ListViewItem.ListViewSubItemPublic Function Add (text As String) As ListViewItem.ListViewSubItemパラメーター
- text
- String
サブ項目に表示するテキスト。
戻り値
コレクションに追加された ListViewItem.ListViewSubItem 。
例
次のコード例では、3 つのListViewItem オブジェクトを指定し、項目ごとに 3 つのListViewItem.ListViewSubItem オブジェクトを指定して、ListView コントロールを作成します。 この例では、詳細ビューにサブ項目を表示する ColumnHeader オブジェクトも作成します。 コード例では、ListViewItem オブジェクトのイメージを提供するために、2 つのImageList オブジェクトも作成されます。 これらの ImageList オブジェクトは、 LargeImageList プロパティと SmallImageList プロパティに追加されます。 この例では、 ListView コントロールの作成に次のプロパティを使用します。
この例では、コードを Form に追加し、この例で作成したメソッドをコンストラクターまたはフォーム上の別のメソッドから呼び出す必要があります。 この例では、 MySmallImage1、 MySmallImage2、 MyLargeImage1、 MyLargeImage2 という名前のイメージがドライブ C のルート ディレクトリに配置されている必要もあります。
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.
// Width of -2 indicates auto-size.
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.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.
// Width of -2 indicates auto-size.
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 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.
' Width of -2 indicates auto-size.
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
注釈
このバージョンの Add メソッドを使用すると、サブ項目のテキストを指定して、サブ項目をコレクションに追加できます。 このメソッドが呼び出されると、指定したテキストを使用して新しい ListViewItem.ListViewSubItem が作成されます。 その後、このメソッドによって返される ListViewItem.ListViewSubItem を使用して、プロパティを設定し、サブ項目を操作するメソッドを呼び出すことができます。 コレクションに追加する既存のListViewItem.ListViewSubItemが既にある場合は、ListViewItem.ListViewSubItemをパラメーターとして受け入れる Add メソッドのバージョンを使用するか、コレクション内の特定の位置にサブ項目を追加する場合は Insert メソッドを使用できます。
こちらもご覧ください
適用対象
Add(ListViewItem+ListViewSubItem)
コレクションに既存の ListViewItem.ListViewSubItem を追加します。
public:
System::Windows::Forms::ListViewItem::ListViewSubItem ^ Add(System::Windows::Forms::ListViewItem::ListViewSubItem ^ item);public System.Windows.Forms.ListViewItem.ListViewSubItem Add(System.Windows.Forms.ListViewItem.ListViewSubItem item);member this.Add : System.Windows.Forms.ListViewItem.ListViewSubItem -> System.Windows.Forms.ListViewItem.ListViewSubItemPublic Function Add (item As ListViewItem.ListViewSubItem) As ListViewItem.ListViewSubItemパラメーター
コレクションに追加する ListViewItem.ListViewSubItem 。
戻り値
コレクションに追加された ListViewItem.ListViewSubItem 。
注釈
このバージョンの Add メソッドを使用して、コレクションに既存の ListViewItem.ListViewSubItem を追加できます。 通常、このメソッドは、他の ListViewItem オブジェクトの既存のサブ項目を再利用するために使用されます。 コレクションに追加された項目は、リストの末尾に挿入されます。 コレクション内の特定の位置に項目を挿入するには、 Insert メソッドを使用します。 既存のListViewItem.ListViewSubItem オブジェクトの配列を追加する場合は、ListViewItem.ListViewSubItem オブジェクトの配列をパラメーターとして受け取る AddRange メソッドのバージョンを使用できます。
こちらもご覧ください
適用対象
Add(String, Color, Color, Font)
指定したテキスト、前景色、背景色、およびフォント設定を持つサブ項目をコレクションに追加します。
public:
System::Windows::Forms::ListViewItem::ListViewSubItem ^ Add(System::String ^ text, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font);public System.Windows.Forms.ListViewItem.ListViewSubItem Add(string text, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font);public System.Windows.Forms.ListViewItem.ListViewSubItem Add(string? text, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font);member this.Add : string * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font -> System.Windows.Forms.ListViewItem.ListViewSubItemPublic Function Add (text As String, foreColor As Color, backColor As Color, font As Font) As ListViewItem.ListViewSubItemパラメーター
- text
- String
サブ項目に表示するテキスト。
戻り値
コレクションに追加された ListViewItem.ListViewSubItem 。
注釈
このバージョンの Add メソッドを使用すると、サブ項目のテキストを指定して、サブ項目をコレクションに追加できます。 さらに、このバージョンの Add メソッドを使用すると、サブ項目テキストの初期前景色、背景色、フォントを指定できます。 このメソッドが呼び出されると、指定したテキストを使用して新しい ListViewItem.ListViewSubItem が作成されます。 その後、このメソッドによって返される ListViewItem.ListViewSubItem を使用して、プロパティを設定し、サブ項目を操作するメソッドを呼び出すことができます。 コレクションに追加する既存のListViewItem.ListViewSubItemが既にある場合は、ListViewItem.ListViewSubItemをパラメーターとして受け入れる Add メソッドのバージョンを使用するか、コレクション内の特定の位置にサブ項目を追加する場合は Insert メソッドを使用できます。
注
既定では、サブ項目は親アイテムに指定された前景色、背景色、フォントを使用します。
ListViewItem.UseItemStyleForSubItemsプロパティをfalseに設定すると、親項目のスタイルがサブ項目スタイルをオーバーライドできなくなります。
