Поделиться через


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 ()

Примеры

В следующем примере кода создается ListView элемент управления с тремя ListViewItem указанными объектами и тремя ListViewItem.ListViewSubItem объектами, указанными для каждого элемента. В примере также создаются ColumnHeader объекты для отображения вложенных элементов в представлении сведений. В примере кода также создаются два ImageList объекта для предоставления ListViewItem изображений для объектов . Эти 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

Применяется к

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

Имя изображения, определенного свойством ImageList объекта-владельца ListView, которое должно отображаться в элементе.

foreColor
Color

Объект Color, представляющий цвет переднего плана данного элемента.

backColor
Color

Объект Color, представляющий цвет фона данного элемента.

font
Font

Объект Font для применения к отображаемому тексту.

group
ListViewGroup

Объект ListViewGroup, которому должен быть назначен этот элемент.

Комментарии

Эта версия конструктора позволяет указать группу, к которой принадлежит элемент.

Параметр imageKey указывает изображение в объекте , связанное ImageList с элементом управления-владельцем ListView , к которому можно получить доступ с помощью 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

Имя изображения, определенного свойством ImageList объекта-владельца ListView, которое должно отображаться в элементе.

foreColor
Color

Объект Color, представляющий цвет переднего плана данного элемента.

backColor
Color

Объект Color, представляющий цвет фона данного элемента.

font
Font

Объект Font для применения к отображаемому тексту.

Комментарии

Параметр imageKey указывает изображение в объекте , связанное ImageList с элементом управления-владельцем ListView , к которому можно получить доступ с помощью 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

Имя изображения, определенного свойством ImageList объекта-владельца ListView, которое должно отображаться в элементе.

group
ListViewGroup

Объект ListViewGroup, которому должен быть назначен этот элемент.

Комментарии

Эта версия конструктора полезна при создании ListViewItem.ListViewSubItem объектов перед их добавлением ListViewItem в (например, для указания специального форматирования или использования вложенных элементов в нескольких элементах). Он также позволяет указать группу, к которой принадлежит элемент.

Параметр imageKey указывает изображение в объекте , связанное ImageList с элементом управления-владельцем ListView , к которому можно получить доступ с помощью 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.ListViewSubItem объектов перед их добавлением ListViewItem в объект (например, для указания специального форматирования или использования вложенных элементов в нескольких элементах). Он также позволяет указать группу, к которой принадлежит элемент.

Примечание

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

Имя изображения, определенного свойством ImageList объекта-владельца ListView, которое должно отображаться в элементе.

group
ListViewGroup

Объект ListViewGroup, которому должен быть назначен этот элемент.

Комментарии

Эта версия конструктора позволяет указать группу, к которой принадлежит элемент.

Параметр imageKey указывает изображение в объекте , связанное ImageList с элементом управления-владельцем ListView , к которому можно получить доступ с помощью 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

Имя изображения, определенного свойством ImageList объекта-владельца ListView, которое должно отображаться в элементе.

group
ListViewGroup

Объект ListViewGroup, которому должен быть назначен этот элемент.

Комментарии

Эта версия конструктора позволяет указать группу, к которой принадлежит элемент.

Параметр imageKey указывает изображение в объекте , связанное ImageList с элементом управления-владельцем ListView , к которому можно получить доступ с помощью 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)

Параметры

subItems
ListViewItem.ListViewSubItem[]

Массив объектов ListViewItem.ListViewSubItem.

imageKey
String

Имя изображения, определенного свойством ImageList объекта-владельца ListView, которое должно отображаться в объекте ListViewItem.

Комментарии

Параметр imageKey указывает изображение в объекте , связанное ImageList с элементом управления-владельцем ListView , к которому можно получить доступ с помощью 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 объекта-владельца ListView, которое должно отображаться в объекте ListViewItem.

Комментарии

Параметр imageKey указывает изображение в объекте , связанное ImageList с элементом управления-владельцем ListView , к которому можно получить доступ с помощью 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 объекта-владельца ListView, которое должно отображаться в объекте ListViewItem.

Комментарии

Параметр imageKey указывает изображение в объекте , связанное ImageList с элементом управления-владельцем ListView , к которому можно получить доступ с помощью 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.ListViewSubItem объектов перед их добавлением ListViewItem в (например, для указания специального форматирования или использования вложенных элементов в нескольких элементах).

См. также раздел

Применяется к