ListViewItem Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje element w kontrolce ListView .

public ref class ListViewItem : ICloneable, System::Runtime::Serialization::ISerializable

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ListViewItemConverter))]
[System.Serializable]
public class ListViewItem : ICloneable, System.Runtime.Serialization.ISerializable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ListViewItemConverter))>]
[<System.Serializable>]
type ListViewItem = class
    interface ICloneable
    interface ISerializable

Public Class ListViewItem
Implements ICloneable, ISerializable

Dziedziczenie: Object
ListViewItem

Atrybuty: TypeConverterAttribute SerializableAttribute

Implementuje: ICloneable ISerializable

Przykłady

Poniższy przykład kodu tworzy kontrolkę ListView z trzema określonymi obiektami i trzema ListViewItem ListViewItem.ListViewSubItem obiektami określonymi dla każdego elementu. W przykładzie są również tworzone ColumnHeader obiekty do wyświetlania subitemów w widoku szczegółów. Dwa ImageList obiekty są również tworzone w przykładzie kodu w celu udostępnienia obrazów dla ListViewItem obiektów. Te ImageList obiekty są dodawane do LargeImageList właściwości i SmallImageList . W przykładzie użyto następujących właściwości podczas tworzenia kontrolki ListView :

Należy dodać kod do Form obiektu i wywołać metodę utworzoną w przykładzie z konstruktora lub innej metody w formularzu. Przykład wymaga, aby obrazy o nazwie MySmallImage1, MySmallImage2, MyLargeImage1i MyLargeImage2 znajdowały się w katalogu głównym dysku 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

Uwagi

Kontrolka jest podobna ListView do ListBox kontrolki w tym, że wyświetla listę elementów. Główną różnicą jest to, że kontrolka ListView zapewnia wiele różnych sposobów wyświetlania elementów przez użytkownika. Klasa ListViewItem definiuje wygląd, zachowanie i dane skojarzone z elementem wyświetlanym w kontrolce ListView . ListViewItem obiekty mogą być wyświetlane w kontrolce ListView w jednym z czterech różnych widoków. Elementy mogą być wyświetlane jako duże lub małe ikony lub małe ikony na liście pionowej. Elementy mogą również zawierać elementy podrzędne zawierające informacje powiązane z elementem nadrzędnym. Czwarty styl widoku, widok szczegółów, umożliwia wyświetlanie elementu i jego poditemów w siatce z nagłówkami kolumn, które mogą służyć do identyfikowania informacji wyświetlanych w poditem.

Większość właściwości ListViewItem klasy udostępnia sposoby zmiany wyświetlania elementu w kontrolce ListView , z nią skojarzonej. Właściwości BackColor, ForeColori Font umożliwiają zmianę sposobu wyświetlania tekstu elementu w kontrolce ListView . Właściwość ImageIndex umożliwia określenie obrazu do załadowania z ImageList kontrolki przypisanej do kontrolki ListView (przez ustawienie LargeImageList właściwości lub SmallImageList elementu ListView). Elementy mogą wyświetlać pola wyboru w celu uzyskania opcji elementów od użytkownika w sposób podobny do kontrolki CheckedListBox . Możesz użyć Checked właściwości , aby określić, czy element jest zaznaczony, lub zaznaczyć lub wyczyścić pole wyboru w czasie wykonywania. Elementy mogą wyświetlać dowolną liczbę subitemów, gdy View właściwość skojarzonej ListView kontrolki jest ustawiona na Details , a kolumny są zdefiniowane w ListView.ColumnHeaderCollection kontrolce ListView . Subitems można dodać do elementu, wywołując Add metodę ListViewItem.ListViewSubItemCollection klasy. Właściwość SubItems umożliwia uzyskanie dostępu do ListViewItem.ListViewSubItemCollection klasy i jej składowych.

Niektóre właściwości i metody ListViewItem klasy to wersje właściwości i metod specyficznych dla elementu w kontrolce ListView . Na przykład EnsureVisible metoda jest podobna do ListView wersji metody, ale ListViewItem wersja ma wpływ tylko na bieżący element.

Klasa ListViewItem udostępnia również metody, które nie są wersjami ListView metod. Metoda BeginEdit umieszcza tekst elementu w trybie edycji, aby użytkownik mógł zmienić tekst elementu (gdy LabelEdit właściwość ListView kontrolki jest ustawiona na true). Metoda Clone umożliwia tworzenie kopii istniejących ListViewItem obiektów do ponownego użycia w innych ListView kontrolkach.

Konstruktory

ListViewItem()	Inicjuje nowe wystąpienie klasy ListViewItem z domyślnymi wartościami.
ListViewItem(ListViewGroup)	Inicjuje ListViewItem nowe wystąpienie klasy i przypisuje je do określonej grupy.
ListViewItem(ListViewItem+ListViewSubItem[], Int32)	Inicjuje nowe wystąpienie ListViewItem klasy z położeniem indeksu obrazu ikony elementu i tablicą ListViewItem.ListViewSubItem obiektów.
ListViewItem(ListViewItem+ListViewSubItem[], Int32, ListViewGroup)	Inicjuje nowe wystąpienie ListViewItem klasy z pozycją indeksu obrazu ikony elementu i tablicą ListViewItem.ListViewSubItem obiektów oraz przypisuje element do określonej grupy.
ListViewItem(ListViewItem+ListViewSubItem[], String)	Inicjuje ListViewItem nowe wystąpienie klasy z określonymi poditemami i obrazem.
ListViewItem(ListViewItem+ListViewSubItem[], String, ListViewGroup)	Inicjuje ListViewItem nowe wystąpienie klasy z określonymi podwitemami, obrazem i grupą.
ListViewItem(SerializationInfo, StreamingContext)	Inicjuje ListViewItem nowe wystąpienie klasy z określonymi informacjami o serializacji i kontekstem przesyłania strumieniowego.
ListViewItem(String)	Inicjuje ListViewItem nowe wystąpienie klasy z określonym tekstem elementu.
ListViewItem(String, Int32)	Inicjuje nowe wystąpienie ListViewItem klasy z określonym tekstem elementu i pozycją indeksu obrazu ikony elementu.
ListViewItem(String, Int32, ListViewGroup)	Inicjuje nowe wystąpienie ListViewItem klasy z określonym tekstem elementu i pozycją indeksu obrazu ikony elementu i przypisuje element do określonej grupy.
ListViewItem(String, ListViewGroup)	Inicjuje ListViewItem nowe wystąpienie klasy z określonym tekstem elementu i przypisuje je do określonej grupy.
ListViewItem(String, String)	Inicjuje ListViewItem nowe wystąpienie klasy z określonym tekstem i obrazem.
ListViewItem(String, String, ListViewGroup)	Inicjuje ListViewItem nowe wystąpienie klasy z określonym tekstem, obrazem i grupą.
ListViewItem(String[])	Inicjuje ListViewItem nowe wystąpienie klasy z tablicą ciągów reprezentujących poditemy.
ListViewItem(String[], Int32)	Inicjuje nowe wystąpienie ListViewItem klasy z pozycją indeksu obrazu ikony elementu i tablicą ciągów reprezentujących poditemy.
ListViewItem(String[], Int32, Color, Color, Font)	Inicjuje nowe wystąpienie ListViewItem klasy z pozycją indeksu obrazu ikony elementu, kolorem pierwszego planu, kolorem tła i czcionką elementu oraz tablicą ciągów reprezentujących elementy podrzędne.
ListViewItem(String[], Int32, Color, Color, Font, ListViewGroup)	Inicjuje nowe wystąpienie ListViewItem klasy z pozycją indeksu obrazu ikony elementu, kolorem pierwszego planu, kolorem tła i czcionką elementu oraz tablicą ciągów reprezentujących elementy podrzędne. Przypisuje element do określonej grupy.
ListViewItem(String[], Int32, ListViewGroup)	Inicjuje nowe wystąpienie ListViewItem klasy z pozycją indeksu obrazu ikony elementu i tablicą ciągów reprezentujących podwitięty i przypisuje element do określonej grupy.
ListViewItem(String[], ListViewGroup)	Inicjuje nowe wystąpienie ListViewItem klasy z tablicą ciągów reprezentujących poditemy i przypisuje element do określonej grupy.
ListViewItem(String[], String)	Inicjuje ListViewItem nowe wystąpienie klasy z określonym elementem i tekstem podrzędnym i obrazem.
ListViewItem(String[], String, Color, Color, Font)	Inicjuje ListViewItem nowe wystąpienie klasy z elementami podrzędnymi zawierającymi określony tekst, obraz, kolory i czcionkę.
ListViewItem(String[], String, Color, Color, Font, ListViewGroup)	Inicjuje ListViewItem nowe wystąpienie klasy z elementami podrzędnymi zawierającymi określony tekst, obraz, kolory, czcionkę i grupę.
ListViewItem(String[], String, ListViewGroup)	Inicjuje ListViewItem nowe wystąpienie klasy z elementami podrzędnymi zawierającymi określony tekst, obraz i grupę.

Właściwości

BackColor	Pobiera lub ustawia kolor tła tekstu elementu.
Bounds	Pobiera prostokąt ograniczenia elementu, w tym podwitemy.
Checked	Pobiera lub ustawia wartość wskazującą, czy element jest sprawdzany.
Focused	Pobiera lub ustawia wartość wskazującą, czy element ma fokus w kontrolce ListView .
Font	Pobiera lub ustawia czcionkę tekstu wyświetlanego przez element.
ForeColor	Pobiera lub ustawia kolor pierwszego planu tekstu elementu.
Group	Pobiera lub ustawia grupę, do której jest przypisany element.
ImageIndex	Pobiera lub ustawia indeks obrazu wyświetlanego dla elementu.
ImageKey	Pobiera lub ustawia klucz obrazu wyświetlanego dla elementu.
ImageList	ImageList Pobiera obraz wyświetlany za pomocą elementu .
IndentCount	Pobiera lub ustawia liczbę małych szerokości obrazu, według których ma być wcięcie elementu ListViewItem.
Index	Pobiera zerowy indeks elementu w kontrolce ListView .
ListView	Pobiera kontrolkę ListView zawierającą element.
Name	Pobiera lub ustawia nazwę skojarzona z tym ListViewItemelementem .
Position	Pobiera lub ustawia położenie lewego górnego rogu obiektu ListViewItem.
Selected	Pobiera lub ustawia wartość wskazującą, czy element jest zaznaczony.
StateImageIndex	Pobiera lub ustawia indeks obrazu stanu (obraz, taki jak zaznaczone lub wyczyszczone pole wyboru, które wskazuje stan elementu), które jest wyświetlane dla elementu.
SubItems	Pobiera kolekcję zawierającą wszystkie subitemy elementu.
Tag	Pobiera lub ustawia obiekt zawierający dane do skojarzenia z elementem.
Text	Pobiera lub ustawia tekst elementu.
ToolTipText	Pobiera lub ustawia tekst wyświetlany, gdy wskaźnik myszy spoczywa na obiekcie ListViewItem.
UseItemStyleForSubItems	Pobiera lub ustawia wartość wskazującą, czy Fontwłaściwości , ForeColori BackColor dla elementu są używane dla wszystkich jego elementów podrzędnych.

Metody

BeginEdit()	Umieszcza tekst elementu w trybie edycji.
Clone()	Tworzy identyczną kopię elementu.
Deserialize(SerializationInfo, StreamingContext)	Deserializuje element.
EnsureVisible()	Gwarantuje, że element jest widoczny w kontrolce, przewijając zawartość kontrolki w razie potrzeby.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
FindNearestItem(SearchDirectionHint)	Znajduje następny element z elementu ListViewItem, wyszukując w określonym kierunku.
GetBounds(ItemBoundsPortion)	Pobiera określoną część prostokąta ograniczenia dla elementu.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetSubItemAt(Int32, Int32)	Zwraca subitem wartości ListViewItem na określonych współrzędnych.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
Remove()	Usuwa element ze skojarzonej kontrolki ListView .
Serialize(SerializationInfo, StreamingContext)	Serializuje element.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt.

Jawne implementacje interfejsu

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Serializuje element.

Dotyczy