ListView.ColumnHeaderCollection.Add メソッド

リファレンス

定義

名前空間:: System.Windows.Forms

アセンブリ:: System.Windows.Forms.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

列ヘッダーをコレクションに追加します。

オーバーロード

Add(String)	テキストを指定して列を作成し、コレクションに追加します。
Add(ColumnHeader)	既存の ColumnHeader をコレクションに追加します。
Add(String, Int32)	テキストと幅を指定して列を作成し、コレクションに追加します。
Add(String, String)	テキストとキーを指定して列を作成し、コレクションに追加します。
Add(String, String, Int32)	テキスト、キー、および幅を指定して列を作成し、コレクションに追加します。
Add(String, Int32, HorizontalAlignment)	指定したテキスト、幅、および配置の設定を使用して、列ヘッダーをコレクションに追加します。
Add(String, String, Int32, HorizontalAlignment, Int32)	キー、配置済みのテキスト、幅、およびイメージインデックスを指定して列を作成し、コレクションに追加します。
Add(String, String, Int32, HorizontalAlignment, String)	キー、配置済みのテキスト、幅、およびイメージキーを指定して列を作成し、コレクションに追加します。

Add(String)

テキストを指定して列を作成し、コレクションに追加します。

public:
 virtual System::Windows::Forms::ColumnHeader ^ Add(System::String ^ text);

public virtual System.Windows.Forms.ColumnHeader Add (string text);

public virtual System.Windows.Forms.ColumnHeader Add (string? text);

abstract member Add : string -> System.Windows.Forms.ColumnHeader
override this.Add : string -> System.Windows.Forms.ColumnHeader

Public Overridable Function Add (text As String) As ColumnHeader

パラメーター

text: String

列ヘッダーに表示されるテキスト。

戻り値

ColumnHeader

ColumnHeader に追加された、指定したテキストを持つ ListView.ColumnHeaderCollection。

注釈

列ヘッダーがコレクションの末尾に追加されます。

適用対象

Add(ColumnHeader)

既存の ColumnHeader をコレクションに追加します。

public:
 virtual int Add(System::Windows::Forms::ColumnHeader ^ value);

public virtual int Add (System.Windows.Forms.ColumnHeader value);

abstract member Add : System.Windows.Forms.ColumnHeader -> int
override this.Add : System.Windows.Forms.ColumnHeader -> int

Public Overridable Function Add (value As ColumnHeader) As Integer

パラメーター

value: ColumnHeader

コレクションに追加する ColumnHeader。

戻り値

Int32

項目が追加されたコレクションの 0 から始まるインデックス番号。

例

次のコード例では、コントロール内の列がクリックされたときに項目を ListView 手動で並べ替えるコントロールを含むフォームを ListView 作成します。この例では、比較を実行するインターフェイスをSystem.Collections.IComparer実装するというListViewItemComparerクラスをListViewItem定義します。この例では、のListViewItemComparerインスタンスを作成し、それを使用してコントロールのプロパティをListViewItemSorter ListView設定します。イベントハンドラーのColumnClickメソッド呼び出しではSort、でListViewItemComparer定義されているメソッドを使用して、クリックされた列に基づいて項目の並べ替えを実行します。

#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>

using namespace System;
using namespace System::Windows::Forms;
using namespace System::Drawing;
using namespace System::Collections;

// Implements the manual sorting of items by columns.
ref class ListViewItemComparer: public IComparer
{
private:
   int col;

public:
   ListViewItemComparer()
   {
      col = 0;
   }

   ListViewItemComparer( int column )
   {
      col = column;
   }

   virtual int Compare( Object^ x, Object^ y )
   {
      return String::Compare( (dynamic_cast<ListViewItem^>(x))->SubItems[ col ]->Text,
                              (dynamic_cast<ListViewItem^>(y))->SubItems[ col ]->Text );
   }
};

public ref class ListViewSortForm: public Form
{
private:
   ListView^ listView1;

public:
   ListViewSortForm()
   {
      // Create ListView items to add to the control.
      array<String^>^temp0 = {"Banana","a","b","c"};
      ListViewItem^ listViewItem1 = gcnew ListViewItem( temp0,-1,Color::Empty,Color::Yellow,nullptr );
      array<String^>^temp1 = {"Cherry","v","g","t"};
      ListViewItem^ listViewItem2 = gcnew ListViewItem( temp1,-1,Color::Empty,Color::Red,
                 gcnew System::Drawing::Font( "Microsoft Sans Serif",8.25F,FontStyle::Regular,GraphicsUnit::Point,0 ) );
      array<String^>^temp2 = {"Apple","h","j","n"};
      ListViewItem^ listViewItem3 = gcnew ListViewItem( temp2,-1,Color::Empty,Color::Lime,nullptr );
      array<String^>^temp3 = {"Pear","y","u","i"};
      ListViewItem^ listViewItem4 = gcnew ListViewItem( temp3,-1,Color::Empty,Color::FromArgb( 192, 128, 156 ),nullptr );

      //Initialize the ListView control and add columns to it.
      this->listView1 = gcnew ListView;

      // Set the initial sorting type for the ListView.
      this->listView1->Sorting = SortOrder::None;

      // Disable automatic sorting to enable manual sorting.
      this->listView1->View = View::Details;

      // Add columns and set their text.
      this->listView1->Columns->Add( gcnew ColumnHeader );
      this->listView1->Columns[ 0 ]->Text = "Column 1";
      this->listView1->Columns[ 0 ]->Width = 100;
      listView1->Columns->Add( gcnew ColumnHeader );
      listView1->Columns[ 1 ]->Text = "Column 2";
      listView1->Columns->Add( gcnew ColumnHeader );
      listView1->Columns[ 2 ]->Text = "Column 3";
      listView1->Columns->Add( gcnew ColumnHeader );
      listView1->Columns[ 3 ]->Text = "Column 4";

      // Suspend control logic until form is done configuring form.
      this->SuspendLayout();

      // Add Items to the ListView control.
      array<ListViewItem^>^temp4 = {listViewItem1,listViewItem2,listViewItem3,listViewItem4};
      this->listView1->Items->AddRange( temp4 );

      // Set the location and size of the ListView control.
      this->listView1->Location = Point(10,10);
      this->listView1->Name = "listView1";
      this->listView1->Size = System::Drawing::Size( 300, 100 );
      this->listView1->TabIndex = 0;

      // Enable editing of the items in the ListView.
      this->listView1->LabelEdit = true;

      // Connect the ListView::ColumnClick event to the ColumnClick event handler.
      this->listView1->ColumnClick += gcnew ColumnClickEventHandler( this, &ListViewSortForm::ColumnClick );

      // Initialize the form.
      this->ClientSize = System::Drawing::Size( 400, 400 );
      array<Control^>^temp5 = {this->listView1};
      this->Controls->AddRange( temp5 );
      this->Name = "ListViewSortForm";
      this->Text = "Sorted ListView Control";

      // Resume lay[Out] of* the form.
      this->ResumeLayout( false );
   }

private:

   // ColumnClick event handler.
   void ColumnClick( Object^ /*o*/, ColumnClickEventArgs^ e )
   {
      // Set the ListViewItemSorter property to a new ListViewItemComparer 
      // object. Setting this property immediately sorts the 
      // ListView using the ListViewItemComparer object.
      this->listView1->ListViewItemSorter = gcnew ListViewItemComparer( e->Column );
   }
};

[System::STAThreadAttribute]
int main()
{
   Application::Run( gcnew ListViewSortForm );
}

using System;
using System.Windows.Forms;
using System.Drawing;
using System.Collections;

namespace ListViewSortFormNamespace
{

    public class ListViewSortForm : Form
    {
        private ListView listView1;
       
        public ListViewSortForm()
        {
            // Create ListView items to add to the control.
            ListViewItem listViewItem1 = new ListViewItem(new string[] {"Banana","a","b","c"}, -1, Color.Empty, Color.Yellow, null);
            ListViewItem listViewItem2 = new ListViewItem(new string[] {"Cherry","v","g","t"}, -1, Color.Empty, Color.Red, new Font("Microsoft Sans Serif", 8.25F, FontStyle.Regular, GraphicsUnit.Point, ((System.Byte)(0))));
            ListViewItem listViewItem3 = new ListViewItem(new string[] {"Apple","h","j","n"}, -1, Color.Empty, Color.Lime, null);
            ListViewItem listViewItem4 = new ListViewItem(new string[] {"Pear","y","u","i"}, -1, Color.Empty, Color.FromArgb(((System.Byte)(192)), ((System.Byte)(128)), ((System.Byte)(156))), null);
     
            //Initialize the ListView control and add columns to it.
            this.listView1 = new ListView();

            // Set the initial sorting type for the ListView.
            this.listView1.Sorting = SortOrder.None;
            // Disable automatic sorting to enable manual sorting.
            this.listView1.View = View.Details;
            // Add columns and set their text.
            this.listView1.Columns.Add(new ColumnHeader());
            this.listView1.Columns[0].Text = "Column 1";
            this.listView1.Columns[0].Width = 100;
            listView1.Columns.Add(new ColumnHeader());
            listView1.Columns[1].Text = "Column 2";
            listView1.Columns.Add(new ColumnHeader());
            listView1.Columns[2].Text = "Column 3";
            listView1.Columns.Add(new ColumnHeader());
            listView1.Columns[3].Text = "Column 4";
            // Suspend control logic until form is done configuring form.
            this.SuspendLayout();
            // Add Items to the ListView control.
            this.listView1.Items.AddRange(new ListViewItem[] {listViewItem1,
                listViewItem2,
                listViewItem3,
                listViewItem4});
            // Set the location and size of the ListView control.
            this.listView1.Location = new Point(10, 10);
            this.listView1.Name = "listView1";
            this.listView1.Size = new Size(300, 100);
            this.listView1.TabIndex = 0;
            // Enable editing of the items in the ListView.
            this.listView1.LabelEdit = true;
            // Connect the ListView.ColumnClick event to the ColumnClick event handler.
            this.listView1.ColumnClick += new ColumnClickEventHandler(ColumnClick);
            
            // Initialize the form.
            this.ClientSize = new Size(400, 400);
            this.Controls.AddRange(new Control[] {this.listView1});
            this.Name = "ListViewSortForm";
            this.Text = "Sorted ListView Control";
            // Resume layout of the form.
            this.ResumeLayout(false);
        }

        // ColumnClick event handler.
        private void ColumnClick(object o, ColumnClickEventArgs e)
        {
            // Set the ListViewItemSorter property to a new ListViewItemComparer 
            // object. Setting this property immediately sorts the 
            // ListView using the ListViewItemComparer object.
            this.listView1.ListViewItemSorter = new ListViewItemComparer(e.Column);
        }

        [System.STAThreadAttribute()]
        public static void Main()
        {
            Application.Run(new ListViewSortForm());
        }
    }

    // Implements the manual sorting of items by columns.
    class ListViewItemComparer : IComparer
    {
        private int col;
        public ListViewItemComparer()
        {
            col = 0;
        }
        public ListViewItemComparer(int column)
        {
            col = column;
        }
        public int Compare(object x, object y)
        {
            return String.Compare(((ListViewItem)x).SubItems[col].Text, ((ListViewItem)y).SubItems[col].Text);
        }
    }
}

Imports System.Windows.Forms
Imports System.Drawing
Imports System.Collections


Namespace ListViewSortFormNamespace

    Public Class ListViewSortForm
        Inherits Form

        Private listView1 As ListView

        Public Sub New()
            ' Create ListView items to add to the control.
            Dim listViewItem1 As New ListViewItem(New String() {"Banana", "a", "b", "c"}, -1, Color.Empty, Color.Yellow, Nothing)
            Dim listViewItem2 As New ListViewItem(New String() {"Cherry", "v", "g", "t"}, -1, Color.Empty, Color.Red, New Font("Microsoft Sans Serif", 8.25F, FontStyle.Regular, GraphicsUnit.Point, CType(0, System.Byte)))
            Dim listViewItem3 As New ListViewItem(New String() {"Apple", "h", "j", "n"}, -1, Color.Empty, Color.Lime, Nothing)
            Dim listViewItem4 As New ListViewItem(New String() {"Pear", "y", "u", "i"}, -1, Color.Empty, Color.FromArgb(CType(192, System.Byte), CType(128, System.Byte), CType(156, System.Byte)), Nothing)

            'Initialize the ListView control and add columns to it.
            Me.listView1 = New ListView

            ' Set the initial sorting type for the ListView.
            Me.listView1.Sorting = SortOrder.None
            ' Disable automatic sorting to enable manual sorting.
            Me.listView1.View = View.Details
            ' Add columns and set their text.
            Me.listView1.Columns.Add(New ColumnHeader)
            Me.listView1.Columns(0).Text = "Column 1"
            Me.listView1.Columns(0).Width = 100
            listView1.Columns.Add(New ColumnHeader)
            listView1.Columns(1).Text = "Column 2"
            listView1.Columns.Add(New ColumnHeader)
            listView1.Columns(2).Text = "Column 3"
            listView1.Columns.Add(New ColumnHeader)
            listView1.Columns(3).Text = "Column 4"
            ' Suspend control logic until form is done configuring form.
            Me.SuspendLayout()
            ' Add Items to the ListView control.
            Me.listView1.Items.AddRange(New ListViewItem() {listViewItem1, listViewItem2, listViewItem3, listViewItem4})
            ' Set the location and size of the ListView control.
            Me.listView1.Location = New Point(10, 10)
            Me.listView1.Name = "listView1"
            Me.listView1.Size = New Size(300, 100)
            Me.listView1.TabIndex = 0
            ' Enable editing of the items in the ListView.
            Me.listView1.LabelEdit = True
            ' Connect the ListView.ColumnClick event to the ColumnClick event handler.
            AddHandler Me.listView1.ColumnClick, AddressOf ColumnClick

            ' Initialize the form.
            Me.ClientSize = New Size(400, 400)
            Me.Controls.AddRange(New Control() {Me.listView1})
            Me.Name = "ListViewSortForm"
            Me.Text = "Sorted ListView Control"
            ' Resume layout of the form.
            Me.ResumeLayout(False)
        End Sub


        ' ColumnClick event handler.
        Private Sub ColumnClick(ByVal o As Object, ByVal e As ColumnClickEventArgs)
            ' Set the ListViewItemSorter property to a new ListViewItemComparer 
            ' object. Setting this property immediately sorts the 
            ' ListView using the ListViewItemComparer object.
            Me.listView1.ListViewItemSorter = New ListViewItemComparer(e.Column)
        End Sub

    End Class

    ' Implements the manual sorting of items by columns.
    Class ListViewItemComparer
        Implements IComparer

        Private col As Integer

        Public Sub New()
            col = 0
        End Sub

        Public Sub New(ByVal column As Integer)
            col = column
        End Sub

        Public Function Compare(ByVal x As Object, ByVal y As Object) As Integer _
           Implements IComparer.Compare
            Return [String].Compare(CType(x, ListViewItem).SubItems(col).Text, CType(y, ListViewItem).SubItems(col).Text)
        End Function
    End Class
End Namespace

注釈

このバージョンのメソッドを使用して、 Add コレクションに既存 ColumnHeader のを追加できます。コレクションに追加するときに新しい ColumnHeader を作成する場合は、他のバージョンのメソッドを Add 使用できます。

列ヘッダーを追加すると、コレクションの末尾に列ヘッダーが追加されます。特定の位置にある列ヘッダーをコレクションに挿入するには、メソッドを Insert 使用します。 1 回の操作で列ヘッダーのセットをコレクションに追加するには、メソッドを AddRange 使用します。

こちらもご覧ください

適用対象

Add(String, Int32)

テキストと幅を指定して列を作成し、コレクションに追加します。

public:
 virtual System::Windows::Forms::ColumnHeader ^ Add(System::String ^ text, int width);

public virtual System.Windows.Forms.ColumnHeader Add (string text, int width);

public virtual System.Windows.Forms.ColumnHeader Add (string? text, int width);

abstract member Add : string * int -> System.Windows.Forms.ColumnHeader
override this.Add : string * int -> System.Windows.Forms.ColumnHeader

Public Overridable Function Add (text As String, width As Integer) As ColumnHeader

パラメーター

text: String

コレクションに追加する ColumnHeader のテキスト。

width: Int32

コレクションに追加する ColumnHeader の幅。

戻り値

ColumnHeader

ColumnHeader に追加された、指定したテキストと幅を持つ ListView.ColumnHeaderCollection。

注釈

列はコレクションの末尾に追加されます。

適用対象

Add(String, String)

テキストとキーを指定して列を作成し、コレクションに追加します。

public:
 virtual System::Windows::Forms::ColumnHeader ^ Add(System::String ^ key, System::String ^ text);

public virtual System.Windows.Forms.ColumnHeader Add (string key, string text);

abstract member Add : string * string -> System.Windows.Forms.ColumnHeader
override this.Add : string * string -> System.Windows.Forms.ColumnHeader

Public Overridable Function Add (key As String, text As String) As ColumnHeader

パラメーター

key: String

コレクションに追加する ColumnHeader のキー。

text: String

コレクションに追加する ColumnHeader のテキスト。

戻り値

ColumnHeader

ColumnHeader に追加された、指定したキーとテキストを持つ ListView.ColumnHeaderCollection。

注釈

プロパティは Name 、内の列のキーに ListView.ColumnHeaderCollection対応します。

列はコレクションの末尾に追加されます。

適用対象

Add(String, String, Int32)

テキスト、キー、および幅を指定して列を作成し、コレクションに追加します。

public:
 virtual System::Windows::Forms::ColumnHeader ^ Add(System::String ^ key, System::String ^ text, int width);

public virtual System.Windows.Forms.ColumnHeader Add (string key, string text, int width);

abstract member Add : string * string * int -> System.Windows.Forms.ColumnHeader
override this.Add : string * string * int -> System.Windows.Forms.ColumnHeader

Public Overridable Function Add (key As String, text As String, width As Integer) As ColumnHeader

パラメーター

key: String

列ヘッダーのキー。

text: String

列ヘッダーに表示されるテキスト。

width: Int32

ColumnHeader の初期の幅。

戻り値

ColumnHeader

コレクションに追加された、指定したテキスト、キー、および幅を持つ ColumnHeader。

注釈

プロパティは Name 、内の列のキーに ListView.ColumnHeaderCollection対応します。

列はコレクションの末尾に追加されます。

適用対象

Add(String, Int32, HorizontalAlignment)

指定したテキスト、幅、および配置の設定を使用して、列ヘッダーをコレクションに追加します。

public:
 virtual System::Windows::Forms::ColumnHeader ^ Add(System::String ^ str, int width, System::Windows::Forms::HorizontalAlignment textAlign);

public:
 virtual System::Windows::Forms::ColumnHeader ^ Add(System::String ^ text, int width, System::Windows::Forms::HorizontalAlignment textAlign);

public virtual System.Windows.Forms.ColumnHeader Add (string str, int width, System.Windows.Forms.HorizontalAlignment textAlign);

public virtual System.Windows.Forms.ColumnHeader Add (string text, int width, System.Windows.Forms.HorizontalAlignment textAlign);

public virtual System.Windows.Forms.ColumnHeader Add (string? text, int width, System.Windows.Forms.HorizontalAlignment textAlign);

abstract member Add : string * int * System.Windows.Forms.HorizontalAlignment -> System.Windows.Forms.ColumnHeader
override this.Add : string * int * System.Windows.Forms.HorizontalAlignment -> System.Windows.Forms.ColumnHeader

abstract member Add : string * int * System.Windows.Forms.HorizontalAlignment -> System.Windows.Forms.ColumnHeader
override this.Add : string * int * System.Windows.Forms.HorizontalAlignment -> System.Windows.Forms.ColumnHeader

Public Overridable Function Add (str As String, width As Integer, textAlign As HorizontalAlignment) As ColumnHeader

Public Overridable Function Add (text As String, width As Integer, textAlign As HorizontalAlignment) As ColumnHeader

パラメーター

strtext: String

列ヘッダーに表示されるテキスト。

width: Int32

列ヘッダーの初期の幅。

textAlign: HorizontalAlignment

HorizontalAlignment 値のいずれか 1 つ。

戻り値

ColumnHeader

作成され、コレクションに追加された ColumnHeader。

例

次のコード例では、3 つのListViewItemオブジェクトをListView指定し、項目ごとに 3 つのListViewItem.ListViewSubItemオブジェクトを指定してコントロールを作成します。この例では、詳細ビューにサブ項目を表示するオブジェクトも作成 ColumnHeader します。コード例では、オブジェクトのイメージListViewItemを提供するために、2 つのImageListオブジェクトも作成されます。これらのImageListオブジェクトは、プロパティと SmallImageList プロパティにLargeImageList追加されます。この例では、コントロールの作成に次のプロパティを ListView 使用します。

この例では、コードをに Form 追加し、この例で作成したメソッドをフォームのコンストラクターまたは別のメソッドから呼び出す必要があります。この例では、、MySmallImage2、MyLargeImage1MyLargeImage2、という名前MySmallImage1のイメージがドライブ 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 コレクションに追加する新しい ColumnHeader を作成できます。コントロールに追加された新しい ColumnHeader のテキストは、 text パラメーターに基づいています。このバージョンの Add メソッドでは、列の幅と列ヘッダー内のテキストの配置を指定することもできます。コレクションに追加する既存 ColumnHeader のがある場合は、パラメーターとしてを受け入れるメソッドの Add バージョンを ColumnHeader 使用します。

こちらもご覧ください

適用対象

Add(String, String, Int32, HorizontalAlignment, Int32)

キー、配置済みのテキスト、幅、およびイメージインデックスを指定して列を作成し、コレクションに追加します。

public:
 virtual System::Windows::Forms::ColumnHeader ^ Add(System::String ^ key, System::String ^ text, int width, System::Windows::Forms::HorizontalAlignment textAlign, int imageIndex);

public virtual System.Windows.Forms.ColumnHeader Add (string key, string text, int width, System.Windows.Forms.HorizontalAlignment textAlign, int imageIndex);

abstract member Add : string * string * int * System.Windows.Forms.HorizontalAlignment * int -> System.Windows.Forms.ColumnHeader
override this.Add : string * string * int * System.Windows.Forms.HorizontalAlignment * int -> System.Windows.Forms.ColumnHeader

Public Overridable Function Add (key As String, text As String, width As Integer, textAlign As HorizontalAlignment, imageIndex As Integer) As ColumnHeader

パラメーター

key: String

列ヘッダーのキー。

text: String

列ヘッダーに表示されるテキスト。

width: Int32

列ヘッダーの初期の幅。

textAlign: HorizontalAlignment

HorizontalAlignment 値のいずれか 1 つ。

imageIndex: Int32

列に表示されるイメージのインデックス値。

戻り値

ColumnHeader

キー、配置済みのテキスト、幅、およびイメージインデックスを指定して、コレクションに追加された ColumnHeader。

注釈

プロパティは Name 、内の列のキーに ListView.ColumnHeaderCollection対応します。

列はコレクションの末尾に追加されます。

適用対象

Add(String, String, Int32, HorizontalAlignment, String)

キー、配置済みのテキスト、幅、およびイメージキーを指定して列を作成し、コレクションに追加します。

public:
 virtual System::Windows::Forms::ColumnHeader ^ Add(System::String ^ key, System::String ^ text, int width, System::Windows::Forms::HorizontalAlignment textAlign, System::String ^ imageKey);

public virtual System.Windows.Forms.ColumnHeader Add (string key, string text, int width, System.Windows.Forms.HorizontalAlignment textAlign, string imageKey);

public virtual System.Windows.Forms.ColumnHeader Add (string? key, string? text, int width, System.Windows.Forms.HorizontalAlignment textAlign, string imageKey);

abstract member Add : string * string * int * System.Windows.Forms.HorizontalAlignment * string -> System.Windows.Forms.ColumnHeader
override this.Add : string * string * int * System.Windows.Forms.HorizontalAlignment * string -> System.Windows.Forms.ColumnHeader

Public Overridable Function Add (key As String, text As String, width As Integer, textAlign As HorizontalAlignment, imageKey As String) As ColumnHeader

パラメーター

key: String

列ヘッダーのキー。

text: String

列ヘッダーに表示されるテキスト。

width: Int32

列ヘッダーの初期の幅。

textAlign: HorizontalAlignment

HorizontalAlignment 値のいずれか 1 つ。

imageKey: String

列ヘッダーに表示されるイメージのキー値。

戻り値

ColumnHeader

キー、配置済みのテキスト、幅、およびイメージキーを指定して、コレクションに追加された、ColumnHeader。

注釈

プロパティは Name 、内の列のキーに ListView.ColumnHeaderCollection対応します。

列はコレクションの末尾に追加されます。

適用対象

次の方法で共有

ListView.ColumnHeaderCollection.Add メソッド

定義

オーバーロード

Add(String)

パラメーター

戻り値

注釈

適用対象

Add(ColumnHeader)

パラメーター

戻り値

例

注釈

こちらもご覧ください

適用対象

Add(String, Int32)

パラメーター

戻り値

注釈

適用対象

Add(String, String)

パラメーター

戻り値

注釈

適用対象

Add(String, String, Int32)

パラメーター

戻り値

注釈

適用対象

Add(String, Int32, HorizontalAlignment)

パラメーター

戻り値

例

注釈

こちらもご覧ください

適用対象

Add(String, String, Int32, HorizontalAlignment, Int32)

パラメーター

戻り値

注釈

適用対象

Add(String, String, Int32, HorizontalAlignment, String)

パラメーター

戻り値

注釈

適用対象

その他のリソース