ListViewItem 建構函式

定義

初始化 ListViewItem 類別的新執行個體。

多載

ListViewItem()

使用預設值,初始化 ListViewItem 類別的新執行個體。

ListViewItem(String[], String, Color, Color, Font, ListViewGroup)

使用包含指定之文字、影像、色彩、字型和群組的子項目,初始化 ListViewItem 類別的新執行個體。

ListViewItem(String[], Int32, Color, Color, Font, ListViewGroup)

使用項目圖示的影像索引位置、項目的前景色彩、背景色彩與字型以及表示子項目的字串陣列,初始化 ListViewItem 類別的新執行個體。 此外,將此項目指派給指定的群組。

ListViewItem(String[], String, Color, Color, Font)

使用包含指定之文字、影像、色彩和字型的子項目,初始化 ListViewItem 類別的新執行個體。

ListViewItem(String[], Int32, Color, Color, Font)

使用項目圖示的影像索引位置、項目的前景色彩、背景色彩與字型以及表示子項目的字串陣列,初始化 ListViewItem 類別的新執行個體。

ListViewItem(ListViewItem+ListViewSubItem[], String, ListViewGroup)

使用指定的子項目、影像和群組,初始化 ListViewItem 類別的新執行個體。

ListViewItem(ListViewItem+ListViewSubItem[], Int32, ListViewGroup)

使用項目圖示的影像索引位置和 ListViewItem 物件的陣列,初始化 ListViewItem.ListViewSubItem 類別的新執行個體,並將此項目指派給指定的群組。

ListViewItem(String[], String, ListViewGroup)

使用包含指定之文字、影像和群組的子項目,初始化 ListViewItem 類別的新執行個體。

ListViewItem(String[], Int32, ListViewGroup)

使用項目圖示的影像索引位置和表示子項目的字串陣列,初始化 ListViewItem 類別的新執行個體,並將此項目指派給指定的群組。

ListViewItem(String, String, ListViewGroup)

使用指定的文字、影像和群組,初始化 ListViewItem 類別的新執行個體。

ListViewItem(ListViewItem+ListViewSubItem[], String)

使用指定的子項目和影像,初始化 ListViewItem 類別的新執行個體。

ListViewItem(String, Int32, ListViewGroup)

使用指定的項目文字和項目圖示的影像索引位置,初始化 ListViewItem 類別的新執行個體,並將此項目指派給指定的群組。

ListViewItem(String[], ListViewGroup)

使用表示子項目的字串陣列,初始化 ListViewItem 類別的新執行個體,並將此項目指派給指定的群組。

ListViewItem(String[], String)

使用指定的項目和子項目文字及影像,初始化 ListViewItem 類別的新執行個體。

ListViewItem(String[], Int32)

使用項目圖示的影像索引位置和表示子項目的字串陣列,初始化 ListViewItem 類別的新執行個體。

ListViewItem(String, ListViewGroup)

使用指定的項目文字,初始化 ListViewItem 類別的新執行個體,並將它指派給指定的群組。

ListViewItem(String, String)

使用指定的文字和影像,初始化 ListViewItem 類別的新執行個體。

ListViewItem(String, Int32)

使用指定的項目文字和項目圖示的影像索引位置,初始化 ListViewItem 類別的新執行個體。

ListViewItem(SerializationInfo, StreamingContext)

以指定的序列化資訊和資料流內容,將 ListViewItem 類別的新執行個體初始化。

ListViewItem(ListViewGroup)

初始化 ListViewItem 類別的新執行個體,並將它指派給指定的群組。

ListViewItem(String[])

使用代表子項目的字串陣列,初始化 ListViewItem 類別的新執行個體。

ListViewItem(String)

使用指定的項目文字,初始化 ListViewItem 類別的新執行個體。

ListViewItem(ListViewItem+ListViewSubItem[], Int32)

使用項目圖示的影像索引位置和 ListViewItem 物件的陣列,初始化 ListViewItem.ListViewSubItem 類別的新執行個體。

ListViewItem()

使用預設值,初始化 ListViewItem 類別的新執行個體。

public:
 ListViewItem();
public ListViewItem ();
Public Sub New ()

範例

下列程式碼範例會建立控制項,其中指定三 ListViewItem 個物件,以及針對每個專案指定的三 ListViewItem.ListViewSubItemListView 物件。 此範例也會建立 ColumnHeader 物件,以顯示詳細資料檢視中的子專案。 程式碼範例中也會建立兩 ImageList 個 物件,以提供 物件的影像 ListViewItem 。 這些 ImageList 物件會新增至 LargeImageListSmallImageList 屬性。 此範例會在建立 ListView 控制項時使用下列屬性:

您必須將程式碼新增至 Form ,並從表單上的建構函式或其他方法呼叫在範例中建立的方法。 此範例要求名為 MySmallImage1MySmallImage2MyLargeImage1 和 的 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

適用於

ListViewItem(String[], String, Color, Color, Font, ListViewGroup)

使用包含指定之文字、影像、色彩、字型和群組的子項目,初始化 ListViewItem 類別的新執行個體。

public:
 ListViewItem(cli::array <System::String ^> ^ items, System::String ^ imageKey, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string[] items, string imageKey, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string[]? items, string? imageKey, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font? font, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string[] * string * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageKey As String, foreColor As Color, backColor As Color, font As Font, group As ListViewGroup)

參數

items
String[]

字串的陣列,表示 ListViewItem 之子項目的文字。

imageKey
String

要顯示在項目中的主控 ImageListListView 內之影像名稱。

foreColor
Color

Color,表示項目的前景色彩。

backColor
Color

Color,表示項目的背景色彩。

font
Font

要套用到項目文字的 Font

group
ListViewGroup

要指派項目的 ListViewGroup

備註

這個版本的建構函式可讓您指定專案所屬的群組。

參數 imageKey 會指定與擁有 ListView 控制項相關聯之 中的 ImageList 影像,您可以使用 屬性存取 ImageList 該影像。

注意

ListView 群組僅適用于 Windows XP 和 Windows Server 2003 系列 (Windows XP Home Edition、Windows XP Professional、Windows Server 2003) 。 如需詳細資訊,請參閱 ListViewGroup 概觀主題。

適用於

ListViewItem(String[], Int32, Color, Color, Font, ListViewGroup)

使用項目圖示的影像索引位置、項目的前景色彩、背景色彩與字型以及表示子項目的字串陣列,初始化 ListViewItem 類別的新執行個體。 此外,將此項目指派給指定的群組。

public:
 ListViewItem(cli::array <System::String ^> ^ items, int imageIndex, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string[] items, int imageIndex, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string[]? items, int imageIndex, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font? font, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string[] * int * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageIndex As Integer, foreColor As Color, backColor As Color, font As Font, group As ListViewGroup)

參數

items
String[]

字串陣列,代表新項目的子項目。

imageIndex
Int32

ImageList 內的影像之以零起始的索引,此清單與包含此項目之 ListView 有關聯。

foreColor
Color

Color,表示項目的前景色彩。

backColor
Color

Color,表示項目的背景色彩。

font
Font

Font,表示顯示項目文字所用的字型。

group
ListViewGroup

要指派項目的 ListViewGroup

備註

這個版本的建構函式可讓您指定專案所屬的群組。

注意

ListView 群組僅適用于 Windows XP 和 Windows Server 2003 系列 (Windows XP Home Edition、Windows XP Professional、Windows Server 2003) 。 如需詳細資訊,請參閱 ListViewGroup 概觀主題。

另請參閱

適用於

ListViewItem(String[], String, Color, Color, Font)

使用包含指定之文字、影像、色彩和字型的子項目,初始化 ListViewItem 類別的新執行個體。

public:
 ListViewItem(cli::array <System::String ^> ^ items, System::String ^ imageKey, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font);
public ListViewItem (string[] items, string imageKey, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font);
public ListViewItem (string[]? items, string? imageKey, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font? font);
new System.Windows.Forms.ListViewItem : string[] * string * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageKey As String, foreColor As Color, backColor As Color, font As Font)

參數

items
String[]

字串的陣列,表示 ListViewItem 之子項目的文字。

imageKey
String

要顯示在項目中的主控 ImageListListView 內之影像名稱。

foreColor
Color

Color,表示項目的前景色彩。

backColor
Color

Color,表示項目的背景色彩。

font
Font

要套用到項目文字的 Font

備註

參數 imageKey 會指定與擁有 ListView 控制項相關聯之 中的 ImageList 影像,您可以使用 屬性存取 ImageList 該影像。

適用於

ListViewItem(String[], Int32, Color, Color, Font)

使用項目圖示的影像索引位置、項目的前景色彩、背景色彩與字型以及表示子項目的字串陣列,初始化 ListViewItem 類別的新執行個體。

public:
 ListViewItem(cli::array <System::String ^> ^ items, int imageIndex, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font);
public ListViewItem (string[] items, int imageIndex, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font);
public ListViewItem (string[]? items, int imageIndex, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font? font);
new System.Windows.Forms.ListViewItem : string[] * int * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageIndex As Integer, foreColor As Color, backColor As Color, font As Font)

參數

items
String[]

字串陣列,代表新項目的子項目。

imageIndex
Int32

ImageList 內的影像之以零起始的索引,此清單與包含此項目之 ListView 有關聯。

foreColor
Color

Color,表示項目的前景色彩。

backColor
Color

Color,表示項目的背景色彩。

font
Font

Font,表示顯示項目文字所用的字型。

範例

下列程式碼範例會建立表單,其中包含 ListView 在按一下控制項中的資料 ListView 行時,手動排序專案的控制項。 此範例會定義名為 的 ListViewItemComparer 類別,這個類別會實 System.Collections.IComparer 作執行比較的 ListViewItem 介面。 此範例會建立 的 ListViewItemComparer 實例,並使用它來設定 ListViewItemSorter 控制項的 ListView 屬性。 Sort事件處理常式中的 ColumnClick 方法呼叫會使用 中 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

另請參閱

適用於

ListViewItem(ListViewItem+ListViewSubItem[], String, ListViewGroup)

使用指定的子項目、影像和群組,初始化 ListViewItem 類別的新執行個體。

public:
 ListViewItem(cli::array <System::Windows::Forms::ListViewItem::ListViewSubItem ^> ^ subItems, System::String ^ imageKey, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, string imageKey, System.Windows.Forms.ListViewGroup group);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, string? imageKey, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : System.Windows.Forms.ListViewItem.ListViewSubItem[] * string * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (subItems As ListViewItem.ListViewSubItem(), imageKey As String, group As ListViewGroup)

參數

subItems
ListViewItem.ListViewSubItem[]

ListViewItem.ListViewSubItem 物件的陣列,表示 ListViewItem 的子項目。

imageKey
String

要顯示在項目中的主控 ImageListListView 內之影像名稱。

group
ListViewGroup

要指派項目的 ListViewGroup

備註

當您在將物件新增至 ListViewItem (之前,這個版本的建 ListViewItem.ListViewSubItem 構函式很有用,例如,表示特殊格式設定或使用多個專案中的子專案) 。 它也可讓您指定專案所屬的群組。

參數 imageKey 會指定與擁有 ListView 控制項相關聯之 中的 ImageList 影像,這個影像可以使用 屬性進行存取 ImageList

注意

ListView 群組僅適用于 Windows XP 和 Windows Server 2003 系列 (Windows XP Home Edition、Windows XP Professional、Windows Server 2003) 。 如需詳細資訊,請參閱 ListViewGroup 概觀主題。

適用於

ListViewItem(ListViewItem+ListViewSubItem[], Int32, ListViewGroup)

使用項目圖示的影像索引位置和 ListViewItem 物件的陣列,初始化 ListViewItem.ListViewSubItem 類別的新執行個體,並將此項目指派給指定的群組。

public:
 ListViewItem(cli::array <System::Windows::Forms::ListViewItem::ListViewSubItem ^> ^ subItems, int imageIndex, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, int imageIndex, System.Windows.Forms.ListViewGroup group);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, int imageIndex, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : System.Windows.Forms.ListViewItem.ListViewSubItem[] * int * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (subItems As ListViewItem.ListViewSubItem(), imageIndex As Integer, group As ListViewGroup)

參數

subItems
ListViewItem.ListViewSubItem[]

ListViewItem.ListViewSubItem 型別的陣列,表示項目的子項目。

imageIndex
Int32

ImageList 內的影像之以零起始的索引,此清單與包含此項目之 ListView 有關聯。

group
ListViewGroup

要指派項目的 ListViewGroup

備註

當您在將物件新增至 ListViewItem (物件之前, ListViewItem.ListViewSubItem 這個版本的建構函式很有用,例如,表示特殊格式設定或使用多個專案中的子專案) 。 它也可讓您指定專案所屬的群組。

注意

ListView 群組僅適用于 Windows XP 和 Windows Server 2003 系列 (Windows XP Home Edition、Windows XP Professional、Windows Server 2003) 。 如需詳細資訊,請參閱 ListViewGroup 概觀主題。

另請參閱

適用於

ListViewItem(String[], String, ListViewGroup)

使用包含指定之文字、影像和群組的子項目,初始化 ListViewItem 類別的新執行個體。

public:
 ListViewItem(cli::array <System::String ^> ^ items, System::String ^ imageKey, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string[] items, string imageKey, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string[]? items, string? imageKey, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string[] * string * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageKey As String, group As ListViewGroup)

參數

items
String[]

字串的陣列,表示 ListViewItem 之子項目的文字。

imageKey
String

要顯示在項目中的主控 ImageListListView 內之影像名稱。

group
ListViewGroup

要指派項目的 ListViewGroup

備註

這個版本的建構函式可讓您指定專案所屬的群組。

參數 imageKey 會指定與擁有 ListView 控制項相關聯之 中的 ImageList 影像,這個影像可以使用 屬性進行存取 ImageList

注意

ListView 群組僅適用于 Windows XP 和 Windows Server 2003 系列 (Windows XP Home Edition、Windows XP Professional、Windows Server 2003) 。 如需詳細資訊,請參閱 ListViewGroup 概觀主題。

適用於

ListViewItem(String[], Int32, ListViewGroup)

使用項目圖示的影像索引位置和表示子項目的字串陣列,初始化 ListViewItem 類別的新執行個體,並將此項目指派給指定的群組。

public:
 ListViewItem(cli::array <System::String ^> ^ items, int imageIndex, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string[] items, int imageIndex, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string[]? items, int imageIndex, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string[] * int * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageIndex As Integer, group As ListViewGroup)

參數

items
String[]

字串陣列,代表新項目的子項目。

imageIndex
Int32

ImageList 內的影像之以零起始的索引,此清單與包含此項目之 ListView 有關聯。

group
ListViewGroup

要指派項目的 ListViewGroup

備註

這個版本的建構函式可讓您指定專案所屬的群組。

注意

ListView 群組僅適用于 Windows XP 和 Windows Server 2003 系列 (Windows XP Home Edition、Windows XP Professional、Windows Server 2003) 。 如需詳細資訊,請參閱 ListViewGroup 概觀主題。

另請參閱

適用於

ListViewItem(String, String, ListViewGroup)

使用指定的文字、影像和群組,初始化 ListViewItem 類別的新執行個體。

public:
 ListViewItem(System::String ^ text, System::String ^ imageKey, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string text, string imageKey, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string? text, string? imageKey, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string * string * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (text As String, imageKey As String, group As ListViewGroup)

參數

text
String

要顯示的項目文字。 這個文字不應該超過 259 個字元。

imageKey
String

要顯示在項目中的主控 ImageListListView 內之影像名稱。

group
ListViewGroup

要指派項目的 ListViewGroup

備註

這個版本的建構函式可讓您指定專案所屬的群組。

參數 imageKey 會指定與擁有 ListView 控制項相關聯之 中的 ImageList 影像,這個影像可以使用 屬性進行存取 ImageList

注意

ListView 群組僅適用于 Windows XP 和 Windows Server 2003 系列 (Windows XP Home Edition、Windows XP Professional、Windows Server 2003) 。 如需詳細資訊,請參閱 ListViewGroup 概觀主題。

的文字 ListViewItem 不應超過 259 個字元,或可能發生非預期的行為。

適用於

ListViewItem(ListViewItem+ListViewSubItem[], String)

使用指定的子項目和影像,初始化 ListViewItem 類別的新執行個體。

public:
 ListViewItem(cli::array <System::Windows::Forms::ListViewItem::ListViewSubItem ^> ^ subItems, System::String ^ imageKey);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, string imageKey);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, string? imageKey);
new System.Windows.Forms.ListViewItem : System.Windows.Forms.ListViewItem.ListViewSubItem[] * string -> System.Windows.Forms.ListViewItem
Public Sub New (subItems As ListViewItem.ListViewSubItem(), imageKey As String)

參數

imageKey
String

要顯示在 ImageList 中主控 ListViewListViewItem 內的影像名稱。

備註

參數 imageKey 會指定與擁有 ListView 控制項相關聯之 中的 ImageList 影像,這個影像可以使用 屬性進行存取 ImageList

適用於

ListViewItem(String, Int32, ListViewGroup)

使用指定的項目文字和項目圖示的影像索引位置,初始化 ListViewItem 類別的新執行個體,並將此項目指派給指定的群組。

public:
 ListViewItem(System::String ^ text, int imageIndex, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string text, int imageIndex, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string? text, int imageIndex, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string * int * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (text As String, imageIndex As Integer, group As ListViewGroup)

參數

text
String

要顯示的項目文字。 這個文字不應該超過 259 個字元。

imageIndex
Int32

ImageList 內的影像之以零起始的索引,此清單與包含此項目之 ListView 有關聯。

group
ListViewGroup

要指派項目的 ListViewGroup

備註

這個版本的建構函式可讓您指定專案所屬的群組。

注意

ListView 群組僅適用于 Windows XP 和 Windows Server 2003 系列 (Windows XP Home Edition、Windows XP Professional、Windows Server 2003) 。 如需詳細資訊,請參閱 ListViewGroup 概觀主題。

的文字 ListViewItem 不應超過 259 個字元,或可能發生非預期的行為。

另請參閱

適用於

ListViewItem(String[], ListViewGroup)

使用表示子項目的字串陣列,初始化 ListViewItem 類別的新執行個體,並將此項目指派給指定的群組。

public:
 ListViewItem(cli::array <System::String ^> ^ items, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string[] items, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string[]? items, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string[] * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), group As ListViewGroup)

參數

items
String[]

字串陣列,代表新項目的子項目。

group
ListViewGroup

要指派項目的 ListViewGroup

備註

這個版本的建構函式可讓您指定專案所屬的群組。

注意

ListView 群組僅適用于 Windows XP 和 Windows Server 2003 系列 (Windows XP Home Edition、Windows XP Professional、Windows Server 2003) 。 如需詳細資訊,請參閱 ListViewGroup 概觀主題。

另請參閱

適用於

ListViewItem(String[], String)

使用指定的項目和子項目文字及影像,初始化 ListViewItem 類別的新執行個體。

public:
 ListViewItem(cli::array <System::String ^> ^ items, System::String ^ imageKey);
public ListViewItem (string[] items, string imageKey);
public ListViewItem (string[]? items, string? imageKey);
new System.Windows.Forms.ListViewItem : string[] * string -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageKey As String)

參數

items
String[]

含有 ListViewItem 之子項目文字的陣列。

imageKey
String

要顯示在 ImageList 中主控 ListViewListViewItem 內的影像名稱。

備註

參數 imageKey 會指定與擁有 ListView 控制項相關聯之 中的 ImageList 影像,這個影像可以使用 屬性進行存取 ImageList

適用於

ListViewItem(String[], Int32)

使用項目圖示的影像索引位置和表示子項目的字串陣列,初始化 ListViewItem 類別的新執行個體。

public:
 ListViewItem(cli::array <System::String ^> ^ items, int imageIndex);
public ListViewItem (string[] items, int imageIndex);
public ListViewItem (string[]? items, int imageIndex);
new System.Windows.Forms.ListViewItem : string[] * int -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageIndex As Integer)

參數

items
String[]

字串陣列,代表新項目的子項目。

imageIndex
Int32

ImageList 內的影像之以零起始的索引,此清單與包含此項目之 ListView 有關聯。

另請參閱

適用於

ListViewItem(String, ListViewGroup)

使用指定的項目文字,初始化 ListViewItem 類別的新執行個體,並將它指派給指定的群組。

public:
 ListViewItem(System::String ^ text, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string text, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string? text, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (text As String, group As ListViewGroup)

參數

text
String

要顯示的項目文字。 這個文字不應該超過 259 個字元。

group
ListViewGroup

要指派項目的 ListViewGroup

備註

這個版本的建構函式可讓您指定專案所屬的群組。

注意

ListView 群組僅適用于 Windows XP 和 Windows Server 2003 系列 (Windows XP Home Edition、Windows XP Professional、Windows Server 2003) 。 如需詳細資訊,請參閱 ListViewGroup 概觀主題。

的文字 ListViewItem 不應超過 259 個字元,或可能發生非預期的行為。

另請參閱

適用於

ListViewItem(String, String)

使用指定的文字和影像,初始化 ListViewItem 類別的新執行個體。

public:
 ListViewItem(System::String ^ text, System::String ^ imageKey);
public ListViewItem (string text, string imageKey);
public ListViewItem (string? text, string? imageKey);
new System.Windows.Forms.ListViewItem : string * string -> System.Windows.Forms.ListViewItem
Public Sub New (text As String, imageKey As String)

參數

text
String

要顯示的項目文字。 這個文字不應該超過 259 個字元。

imageKey
String

要顯示在 ImageList 中主控 ListViewListViewItem 內的影像名稱。

備註

參數 imageKey 會指定與擁有 ListView 控制項相關聯之 中的 ImageList 影像,這個影像可以使用 屬性進行存取 ImageList

的文字 ListViewItem 不應超過 259 個字元,或可能發生非預期的行為。

適用於

ListViewItem(String, Int32)

使用指定的項目文字和項目圖示的影像索引位置,初始化 ListViewItem 類別的新執行個體。

public:
 ListViewItem(System::String ^ text, int imageIndex);
public ListViewItem (string text, int imageIndex);
public ListViewItem (string? text, int imageIndex);
new System.Windows.Forms.ListViewItem : string * int -> System.Windows.Forms.ListViewItem
Public Sub New (text As String, imageIndex As Integer)

參數

text
String

要顯示的項目文字。 這個文字不應該超過 259 個字元。

imageIndex
Int32

ImageList 內的影像之以零起始的索引,此清單與包含此項目之 ListView 有關聯。

備註

的文字 ListViewItem 不應超過 259 個字元,或可能發生非預期的行為。

另請參閱

適用於

ListViewItem(SerializationInfo, StreamingContext)

以指定的序列化資訊和資料流內容,將 ListViewItem 類別的新執行個體初始化。

protected:
 ListViewItem(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
protected ListViewItem (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
new System.Windows.Forms.ListViewItem : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Windows.Forms.ListViewItem
Protected Sub New (info As SerializationInfo, context As StreamingContext)

參數

info
SerializationInfo

SerializationInfo,其中包含要序列化之 ListViewItem 的相關資訊。

context
StreamingContext

StreamingContext,表示序列化資料流的來源目的端和內容資訊。

適用於

ListViewItem(ListViewGroup)

初始化 ListViewItem 類別的新執行個體,並將它指派給指定的群組。

public:
 ListViewItem(System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (System.Windows.Forms.ListViewGroup group);
public ListViewItem (System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (group As ListViewGroup)

參數

group
ListViewGroup

要指派項目的 ListViewGroup

備註

這個版本的建構函式可讓您指定專案所屬的群組。

注意

ListView 群組僅適用于 Windows XP 和 Windows Server 2003 系列 (Windows XP Home Edition、Windows XP Professional、Windows Server 2003) 。 如需詳細資訊,請參閱 ListViewGroup 概觀主題。

另請參閱

適用於

ListViewItem(String[])

使用代表子項目的字串陣列,初始化 ListViewItem 類別的新執行個體。

public:
 ListViewItem(cli::array <System::String ^> ^ items);
public ListViewItem (string[] items);
public ListViewItem (string[]? items);
new System.Windows.Forms.ListViewItem : string[] -> System.Windows.Forms.ListViewItem
Public Sub New (items As String())

參數

items
String[]

字串陣列,代表新項目的子項目。

適用於

ListViewItem(String)

使用指定的項目文字,初始化 ListViewItem 類別的新執行個體。

public:
 ListViewItem(System::String ^ text);
public ListViewItem (string text);
public ListViewItem (string? text);
new System.Windows.Forms.ListViewItem : string -> System.Windows.Forms.ListViewItem
Public Sub New (text As String)

參數

text
String

要顯示的項目文字。 這個文字不應該超過 259 個字元。

備註

ListViewItem 文字不應超過 259 個字元,或可能發生非預期的行為。

適用於

ListViewItem(ListViewItem+ListViewSubItem[], Int32)

使用項目圖示的影像索引位置和 ListViewItem 物件的陣列,初始化 ListViewItem.ListViewSubItem 類別的新執行個體。

public:
 ListViewItem(cli::array <System::Windows::Forms::ListViewItem::ListViewSubItem ^> ^ subItems, int imageIndex);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, int imageIndex);
new System.Windows.Forms.ListViewItem : System.Windows.Forms.ListViewItem.ListViewSubItem[] * int -> System.Windows.Forms.ListViewItem
Public Sub New (subItems As ListViewItem.ListViewSubItem(), imageIndex As Integer)

參數

subItems
ListViewItem.ListViewSubItem[]

ListViewItem.ListViewSubItem 型別的陣列,表示項目的子項目。

imageIndex
Int32

ImageList 內的影像之以零起始的索引,此清單與包含此項目之 ListView 有關聯。

備註

例如,當您在將物件新增至 ListViewItem (之前建立 ListViewItem.ListViewSubItem 物件時,這個版本的建構函式很有用,表示特殊格式設定或使用多個專案中的子專案) 。

另請參閱

適用於