Sdílet prostřednictvím


ListViewItem Třída

Definice

Představuje položku v ovládacím ListView prvku.

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
Dědičnost
ListViewItem
Atributy
Implementuje

Příklady

Následující příklad kódu vytvoří ListView ovládací prvek se třemi ListViewItem objekty zadanými a třemi ListViewItem.ListViewSubItem objekty zadanými pro každou položku. Příklad také vytvoří ColumnHeader objekty pro zobrazení dílčích položek v zobrazení podrobností. V příkladu kódu jsou vytvořeny také dva ImageList objekty, které poskytují obrázky pro ListViewItem objekty. Tyto ImageList objekty se přidají do LargeImageList objektů a SmallImageList vlastností. V příkladu ListView se při vytváření ovládacího prvku používají následující vlastnosti:

Je třeba přidat kód do Form a volat metodu vytvořenou v příkladu z konstruktoru nebo jiné metody ve formuláři. Příklad vyžaduje, aby image s názvem MySmallImage1, MyLargeImage1``MySmallImage2a MyLargeImage2 jsou umístěny v kořenovém adresáři jednotky 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

Poznámky

Ovládací ListView prvek je podobný ListBox jako v tom, že zobrazuje seznam položek. Hlavním rozdílem je, že ListView ovládací prvek poskytuje řadu různých způsobů, jak může uživatel zobrazit položky. Třída ListViewItem definuje vzhled, chování a data přidružená k položce, která se zobrazí v ovládacím ListView prvku. ListViewItem objekty lze zobrazit v ovládacím ListView prvku v jednom ze čtyř různých zobrazení. Položky se dají zobrazit jako velké nebo malé ikony nebo malé ikony ve svislém seznamu. Položky můžou také obsahovat podřízené položky, které obsahují informace související s nadřazenou položkou. Čtvrtý styl zobrazení, zobrazení podrobností, umožňuje zobrazit položku a její podnabídky v mřížce se záhlavími sloupců, které lze použít k identifikaci informací zobrazených v podnabídce.

Většina vlastností ListViewItem třídy poskytuje způsoby, jak změnit zobrazení položky v ovládacím ListView prvku, ke které je přidružen. Vlastnosti BackColora Font , ForeColorumožňují změnit způsob zobrazení textu položky v ovládacím ListView prvku. Vlastnost ImageIndex umožňuje určit image, která se má načíst z ImageList přiřazeného ListView ovládacího prvku (nastavením LargeImageList nebo SmallImageList vlastností ListView). Položky můžou zobrazovat zaškrtávací políčka, aby bylo možné od uživatele získat volby položek podobným ovládacím prvkům CheckedListBox . Vlastnost můžete použít Checked k určení, zda je položka zaškrtnutá, nebo zaškrtnutí nebo zrušení zaškrtnutí políčka za běhu. Položky mohou zobrazit libovolný počet dílčích položek, pokud View je vlastnost přidruženého ListView ovládacího prvku nastavena a Details sloupce jsou definovány v ListView.ColumnHeaderCollection ovládacím ListView prvku. Dílčí položky můžete přidat voláním Add metody ListViewItem.ListViewSubItemCollection třídy. Vlastnost SubItems umožňuje získat přístup ke ListViewItem.ListViewSubItemCollection třídě a jejím členům.

Některé vlastnosti a metody ListViewItem třídy jsou verze vlastností a metod specifických pro položky v ovládacím ListView prvku. EnsureVisible Například metoda je podobná ListView verzi metody, ale ListViewItem verze ovlivňuje pouze aktuální položku.

Třída ListViewItem také poskytuje metody, které nejsou verzemi ListView metod. Metoda BeginEdit umístí text položky do režimu úprav, aby uživatel mohl změnit text položky (když LabelEdit je vlastnost ListView ovládacího prvku nastavena na true). Tato Clone metoda umožňuje vytvořit kopie existujících ListViewItem objektů, které se budou opakovaně používat v jiných ListView ovládacích prvcích.

Konstruktory

ListViewItem()

Inicializuje novou instanci třídy ListViewItem s výchozími hodnotami.

ListViewItem(ListViewGroup)

Inicializuje novou instanci ListViewItem třídy a přiřadí ji k zadané skupině.

ListViewItem(ListViewItem+ListViewSubItem[], Int32)

Inicializuje novou instanci ListViewItem třídy s umístěním indexu obrázku ikony položky a pole ListViewItem.ListViewSubItem objektů.

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

Inicializuje novou instanci ListViewItem třídy s umístěním indexu obrázku ikony položky a pole ListViewItem.ListViewSubItem objektů a přiřadí položku zadané skupině.

ListViewItem(ListViewItem+ListViewSubItem[], String)

Inicializuje novou instanci ListViewItem třídy se zadanými dílčími částmi a obrázkem.

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

Inicializuje novou instanci třídy se zadanými podsítěmi ListViewItem , imagemi a skupinou.

ListViewItem(SerializationInfo, StreamingContext)

Inicializuje novou instanci ListViewItem třídy se zadanými informacemi serializace a kontextem streamování.

ListViewItem(String)

Inicializuje novou instanci ListViewItem třídy se zadaným textem položky.

ListViewItem(String, Int32)

Inicializuje novou instanci ListViewItem třídy se zadaným textem položky a umístěním indexu obrázku ikony položky.

ListViewItem(String, Int32, ListViewGroup)

Inicializuje novou instanci ListViewItem třídy se zadaným textem položky a umístěním indexu obrázku ikony položky a přiřadí položku zadané skupině.

ListViewItem(String, ListViewGroup)

Inicializuje novou instanci ListViewItem třídy se zadaným textem položky a přiřadí ji k zadané skupině.

ListViewItem(String, String)

Inicializuje novou instanci ListViewItem třídy se zadaným textem a obrázkem.

ListViewItem(String, String, ListViewGroup)

Inicializuje novou instanci ListViewItem třídy se zadaným textem, obrázkem a skupinou.

ListViewItem(String[])

Inicializuje novou instanci ListViewItem třídy s polem řetězců představujících podřízené položky.

ListViewItem(String[], Int32)

Inicializuje novou instanci ListViewItem třídy s umístěním indexu obrázku ikony položky a pole řetězců představujících dílčí položky.

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

Inicializuje novou instanci ListViewItem třídy s umístěním indexu obrázku ikony položky, barva popředí, barva pozadí a písmo položky a pole řetězců představujících dílčí položky.

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

Inicializuje novou instanci ListViewItem třídy s umístěním indexu obrázku ikony položky, barva popředí, barva pozadí a písmo položky a pole řetězců představujících dílčí položky. Přiřadí položku zadané skupině.

ListViewItem(String[], Int32, ListViewGroup)

Inicializuje novou instanci ListViewItem třídy s umístěním indexu obrázku ikony položky a pole řetězců představujících dílčí položky a přiřadí položku zadané skupině.

ListViewItem(String[], ListViewGroup)

Inicializuje novou instanci ListViewItem třídy s polem řetězců představujících podřízené položky a přiřadí položku zadané skupině.

ListViewItem(String[], String)

Inicializuje novou instanci ListViewItem třídy se zadanou položkou a dílčím textem a obrázkem.

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

Inicializuje novou instanci ListViewItem třídy s podkatemy obsahující zadaný text, obrázek, barvy a písmo.

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

Inicializuje novou instanci ListViewItem třídy s podkatemy obsahující zadaný text, obrázek, barvy, písmo a skupinu.

ListViewItem(String[], String, ListViewGroup)

Inicializuje novou instanci ListViewItem třídy s subitems obsahující zadaný text, obrázek a skupinu.

Vlastnosti

BackColor

Získá nebo nastaví barvu pozadí textu položky.

Bounds

Získá ohraničující obdélník položky včetně dílčích položek.

Checked

Získá nebo nastaví hodnotu určující, zda je položka zaškrtnutá.

Focused

Získá nebo nastaví hodnotu určující, zda má položka fokus v ovládacím ListView prvku.

Font

Získá nebo nastaví písmo textu zobrazeného položkou.

ForeColor

Získá nebo nastaví barvu popředí textu položky.

Group

Získá nebo nastaví skupinu, ke které je položka přiřazena.

ImageIndex

Získá nebo nastaví index obrázku, který se zobrazí pro položku.

ImageKey

Získá nebo nastaví klíč pro obrázek, který se zobrazí pro položku.

ImageList

ImageList Získá ten, který obsahuje obrázek zobrazený s položkou.

IndentCount

Získá nebo nastaví počet malých šířky obrázku, podle kterých se má odsadit ListViewItem.

Index

Získá nulový index položky v ovládacím ListView prvku.

ListView

ListView Získá ovládací prvek, který obsahuje položku.

Name

Získá nebo nastaví název přidružený k tomuto ListViewItem.

Position

Získá nebo nastaví pozici levého horního rohu ListViewItem.

Selected

Získá nebo nastaví hodnotu určující, zda je položka vybrána.

StateImageIndex

Získá nebo nastaví index obrázku stavu (obrázek, například vybrané nebo nezaškrtané políčko označující stav položky), který se zobrazí pro položku.

SubItems

Získá kolekci obsahující všechny dílčí položky.

Tag

Získá nebo nastaví objekt, který obsahuje data pro přidružení k položce.

Text

Získá nebo nastaví text položky.

ToolTipText

Získá nebo nastaví text zobrazený při umístění ukazatele myši na ListViewItem.

UseItemStyleForSubItems

Získá nebo nastaví hodnotu určující, zda Font, ForeColora BackColor vlastnosti pro položku jsou použity pro všechny jeho dílčí položky.

Metody

BeginEdit()

Umístí text položky do režimu úprav.

Clone()

Vytvoří identickou kopii položky.

Deserialize(SerializationInfo, StreamingContext)

Deserializuje položku.

EnsureVisible()

Zajistí, že je položka viditelná v ovládacím prvku a v případě potřeby se posune obsah ovládacího prvku.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
FindNearestItem(SearchDirectionHint)

Najde další položku ze zadaného ListViewItemsměru hledání.

GetBounds(ItemBoundsPortion)

Načte zadanou část ohraničujícího obdélníku pro položku.

GetHashCode()

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetSubItemAt(Int32, Int32)

Vrátí subitem ListViewItem zadané souřadnice.

GetType()

Type Získá aktuální instanci.

(Zděděno od Object)
MemberwiseClone()

Vytvoří použádnou kopii aktuálního souboru Object.

(Zděděno od Object)
Remove()

Odebere položku z přidruženého ListView ovládacího prvku.

Serialize(SerializationInfo, StreamingContext)

Serializuje položku.

ToString()

Vrátí řetězec, který představuje aktuální objekt.

Explicitní implementace rozhraní

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Serializuje položku.

Platí pro

Viz také