ListViewItem.ListViewSubItemとは? わかりやすく解説

ListViewItem.ListViewSubItem クラス

ListViewItem のサブ項目を表します。

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

<SerializableAttribute> _
Public Class ListViewSubItem
Dim instance As ListViewSubItem
[SerializableAttribute] 
public class ListViewSubItem
[SerializableAttribute] 
public ref class ListViewSubItem
/** @attribute SerializableAttribute() */ 
public class ListViewSubItem
SerializableAttribute 
public class ListViewSubItem
解説解説

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
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
ListViewItem.ListViewSubItem メンバ
System.Windows.Forms 名前空間
ListViewItem クラス

ListViewItem.ListViewSubItem コンストラクタ ()


ListViewItem.ListViewSubItem コンストラクタ (ListViewItem, String, Color, Color, Font)

ListViewItem.ListViewSubItem クラスの新しいインスタンスを、指定したオーナー、テキスト、前景色、背景色、およびフォント値を使用して初期化します。

名前空間: System.Windows.Forms
アセンブリ: 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
)

パラメータ

owner

サブ項目を所有する項目を表す ListViewItem。

text

サブ項目を示すために表示するテキスト。

foreColor

サブ項目の前景色を表す Color。

backColor

サブ項目の背景色を表す Color。

font

サブ項目のテキストを表示するフォントを表す Font。

プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
ListViewItem.ListViewSubItem クラス
ListViewItem.ListViewSubItem メンバ
System.Windows.Forms 名前空間
Color
Font
ListViewItem クラス

ListViewItem.ListViewSubItem コンストラクタ

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.ListViewSubItem メンバ
System.Windows.Forms 名前空間

ListViewItem.ListViewSubItem コンストラクタ (ListViewItem, String)

ListViewItem.ListViewSubItem クラスの新しいインスタンスを、指定したオーナーとテキストを使用して初期化します。

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

Public Sub New ( _
    owner As ListViewItem, _
    text As String _
)
Dim owner As ListViewItem
Dim text As String

Dim instance As New ListViewSubItem(owner,
 text)
public ListViewSubItem (
    ListViewItem owner,
    string text
)
public:
ListViewSubItem (
    ListViewItem^ owner, 
    String^ text
)
public ListViewSubItem (
    ListViewItem owner, 
    String text
)
public function ListViewSubItem (
    owner : ListViewItem, 
    text : String
)

パラメータ

owner

サブ項目を所有する項目を表す ListViewItem。

text

サブ項目を示すために表示するテキスト。

プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
ListViewItem.ListViewSubItem クラス
ListViewItem.ListViewSubItem メンバ
System.Windows.Forms 名前空間
ListViewItem クラス

ListViewItem.ListViewSubItem プロパティ


パブリック プロパティパブリック プロパティ

  名前 説明
パブリック プロパティ Text サブ項目のテキストを取得または設定します。
参照参照

関連項目

ListViewItem.ListViewSubItem クラス
System.Windows.Forms 名前空間
ListViewItem クラス

ListViewItem.ListViewSubItem メソッド


ListViewItem.ListViewSubItem メンバ

ListViewItem のサブ項目を表します。

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


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド ListViewItem.ListViewSubItem オーバーロードされます。 ListViewItem.ListViewSubItem クラスの新しいインスタンスを初期化します。
パブリック プロパティパブリック プロパティ
  名前 説明
パブリック プロパティ Text サブ項目のテキストを取得または設定します。
パブリック メソッドパブリック メソッド
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

ListViewItem.ListViewSubItem クラス
System.Windows.Forms 名前空間
ListViewItem クラス



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「ListViewItem.ListViewSubItem」の関連用語

ListViewItem.ListViewSubItemのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



ListViewItem.ListViewSubItemのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS