ListViewItem Classe

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

ListViewItem.cs

Rappresenta un elemento in un ListView controllo .

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

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

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

Public Class ListViewItem
Implements ICloneable, ISerializable

Ereditarietà

Object

ListViewItem

Attributi

TypeConverterAttribute SerializableAttribute DynamicallyAccessedMembersAttribute

Implementazioni

ICloneable ISerializable

Esempio

Nell'esempio di codice seguente viene creato un ListView controllo con tre ListViewItem oggetti specificati e tre ListViewItem.ListViewSubItem oggetti specificati per ogni elemento. Nell'esempio vengono inoltre creati ColumnHeader oggetti per visualizzare gli elementi secondari nella visualizzazione dettagli. Nell'esempio di codice vengono creati anche due ImageList oggetti per fornire immagini per gli ListViewItem oggetti . Questi ImageList oggetti vengono aggiunti alle LargeImageList proprietà e SmallImageList . Nell'esempio vengono utilizzate le proprietà seguenti nella creazione del ListView controllo :

• View

• LabelEdit

• AllowColumnReorder

• CheckBoxes

• FullRowSelect

• GridLines

• Sorting

È necessario aggiungere il codice a un Form oggetto e chiamare il metodo creato nell'esempio dal costruttore o da un altro metodo nel form. L'esempio richiede che le immagini denominate MySmallImage1, MySmallImage2MyLargeImage1, e MyLargeImage2 si trovino nella directory radice dell'unità 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

Commenti

Il ListView controllo è simile a in ListBox quanto visualizza un elenco di elementi. La differenza principale è che il ListView controllo fornisce diversi modi in cui gli elementi possono essere visualizzati dall'utente. La ListViewItem classe definisce l'aspetto, il comportamento e i dati associati a un elemento visualizzato nel ListView controllo . ListViewItem Gli oggetti possono essere visualizzati nel ListView controllo in una delle quattro visualizzazioni diverse. Gli elementi possono essere visualizzati come icone grandi o piccole o come icone piccole in un elenco verticale. Gli elementi possono anche avere elementi secondari che contengono informazioni correlate all'elemento padre. Il quarto stile di visualizzazione, la visualizzazione dettagli, consente di visualizzare l'elemento e i relativi elementi secondari in una griglia con intestazioni di colonna che possono essere usate per identificare le informazioni visualizzate in un elemento secondario.

La maggior parte delle proprietà della ListViewItem classe consente di modificare la visualizzazione dell'elemento nel ListView controllo a cui è associato. Le BackColorproprietà , ForeColore Font consentono di modificare la modalità di visualizzazione del testo dell'elemento nel ListView controllo . La ImageIndex proprietà consente di specificare l'immagine da caricare dall'oggetto ImageList assegnato al ListView controllo (impostando le LargeImageList proprietà o SmallImageList dell'oggetto ListView). Gli elementi possono visualizzare le caselle di controllo per ottenere le scelte degli elementi dall'utente in modo simile a un CheckedListBox controllo. È possibile utilizzare la Checked proprietà per determinare se un elemento è selezionato o per selezionare o deselezionare la casella di controllo in fase di esecuzione. Gli elementi possono visualizzare un numero qualsiasi di elementi secondari quando la View proprietà del controllo associato ListView è impostata su Details e le colonne sono definite nel ListView.ColumnHeaderCollection controllo ListView . È possibile aggiungere elementi secondari a un elemento chiamando il Add metodo della ListViewItem.ListViewSubItemCollection classe . La SubItems proprietà consente di ottenere l'accesso ListViewItem.ListViewSubItemCollection alla classe e ai relativi membri.

Alcune delle proprietà e dei metodi della classe sono versioni specifiche dell'elemento ListViewItem di proprietà e metodi nel ListView controllo . Ad esempio, il EnsureVisible metodo è simile alla ListView versione del metodo, ma la ListViewItem versione influisce solo sull'elemento corrente.

La ListViewItem classe fornisce anche metodi che non sono versioni di ListView metodi. Il BeginEdit metodo inserisce il testo dell'elemento in modalità di modifica in modo che l'utente possa modificare il testo dell'elemento (quando la LabelEdit proprietà del ListView controllo è impostata su true). Il Clone metodo consente di creare copie di oggetti esistenti ListViewItem da riutilizzare in altri ListView controlli.

Costruttori

Nome	Descrizione
ListViewItem()	Inizializza una nuova istanza della ListViewItem classe con valori predefiniti.
ListViewItem(ListViewGroup)	Inizializza una nuova istanza della ListViewItem classe e la assegna al gruppo specificato.
ListViewItem(ListViewItem+ListViewSubItem[], Int32, ListViewGroup)	Inizializza una nuova istanza della ListViewItem classe con la posizione di indice dell'immagine dell'icona dell'elemento e una matrice di ListViewItem.ListViewSubItem oggetti e assegna l'elemento al gruppo specificato.
ListViewItem(ListViewItem+ListViewSubItem[], Int32)	Inizializza una nuova istanza della ListViewItem classe con la posizione di indice dell'immagine dell'icona dell'elemento e una matrice di ListViewItem.ListViewSubItem oggetti.
ListViewItem(ListViewItem+ListViewSubItem[], String, ListViewGroup)	Inizializza una nuova istanza della ListViewItem classe con gli elementi secondari, l'immagine e il gruppo specificati.
ListViewItem(ListViewItem+ListViewSubItem[], String)	Inizializza una nuova istanza della ListViewItem classe con gli elementi secondari e l'immagine specificati.
ListViewItem(SerializationInfo, StreamingContext)	Inizializza una nuova istanza della ListViewItem classe con le informazioni di serializzazione e il contesto di streaming specificati.
ListViewItem(String, Int32, ListViewGroup)	Inizializza una nuova istanza della ListViewItem classe con il testo dell'elemento specificato e la posizione dell'indice dell'immagine dell'icona dell'elemento e assegna l'elemento al gruppo specificato.
ListViewItem(String, Int32)	Inizializza una nuova istanza della ListViewItem classe con il testo dell'elemento specificato e la posizione dell'indice dell'immagine dell'icona dell'elemento.
ListViewItem(String, ListViewGroup)	Inizializza una nuova istanza della ListViewItem classe con il testo dell'elemento specificato e la assegna al gruppo specificato.
ListViewItem(String, String, ListViewGroup)	Inizializza una nuova istanza della ListViewItem classe con il testo, l'immagine e il gruppo specificati.
ListViewItem(String, String)	Inizializza una nuova istanza della ListViewItem classe con il testo e l'immagine specificati.
ListViewItem(String)	Inizializza una nuova istanza della ListViewItem classe con il testo dell'elemento specificato.
ListViewItem(String[], Int32, Color, Color, Font, ListViewGroup)	Inizializza una nuova istanza della ListViewItem classe con la posizione di indice dell'immagine dell'icona dell'elemento, il colore di primo piano, il colore di sfondo e il tipo di carattere dell'elemento e una matrice di stringhe che rappresentano elementi secondari. Assegna l'elemento al gruppo specificato.
ListViewItem(String[], Int32, Color, Color, Font)	Inizializza una nuova istanza della ListViewItem classe con la posizione di indice dell'immagine dell'icona dell'elemento, il colore di primo piano, il colore di sfondo e il tipo di carattere dell'elemento e una matrice di stringhe che rappresentano elementi secondari.
ListViewItem(String[], Int32, ListViewGroup)	Inizializza una nuova istanza della ListViewItem classe con la posizione di indice dell'immagine dell'icona dell'elemento e una matrice di stringhe che rappresentano gli elementi secondari e assegna l'elemento al gruppo specificato.
ListViewItem(String[], Int32)	Inizializza una nuova istanza della ListViewItem classe con la posizione di indice dell'immagine dell'icona dell'elemento e una matrice di stringhe che rappresentano gli elementi secondari.
ListViewItem(String[], ListViewGroup)	Inizializza una nuova istanza della ListViewItem classe con una matrice di stringhe che rappresentano gli elementi secondari e assegna l'elemento al gruppo specificato.
ListViewItem(String[], String, Color, Color, Font, ListViewGroup)	Inizializza una nuova istanza della ListViewItem classe con gli elementi secondari contenenti il testo, l'immagine, i colori, il tipo di carattere e il gruppo specificati.
ListViewItem(String[], String, Color, Color, Font)	Inizializza una nuova istanza della ListViewItem classe con gli elementi secondari contenenti il testo, l'immagine, i colori e il tipo di carattere specificati.
ListViewItem(String[], String, ListViewGroup)	Inizializza una nuova istanza della ListViewItem classe con elementi secondari contenenti il testo, l'immagine e il gruppo specificati.
ListViewItem(String[], String)	Inizializza una nuova istanza della ListViewItem classe con l'elemento e il testo e l'immagine dell'elemento secondario specificati.
ListViewItem(String[])	Inizializza una nuova istanza della ListViewItem classe con una matrice di stringhe che rappresentano gli elementi secondari.

Proprietà

Nome	Descrizione
BackColor	Ottiene o imposta il colore di sfondo del testo dell'elemento.
Bounds	Ottiene il rettangolo di delimitazione dell'elemento, inclusi gli elementi secondari.
Checked	Ottiene o imposta un valore che indica se l'elemento è selezionato.
Focused	Ottiene o imposta un valore che indica se l'elemento ha lo stato attivo all'interno del ListView controllo .
Font	Ottiene o imposta il tipo di carattere del testo visualizzato dall'elemento.
ForeColor	Ottiene o imposta il colore di primo piano del testo dell'elemento.
Group	Ottiene o imposta il gruppo a cui è assegnato l'elemento.
ImageIndex	Ottiene o imposta l'indice dell'immagine visualizzata per l'elemento.
ImageKey	Ottiene o imposta la chiave per l'immagine visualizzata per l'elemento.
ImageList	Ottiene l'oggetto ImageList contenente l'immagine visualizzata con l'elemento .
IndentCount	Ottiene o imposta il numero di larghezze dell'immagine di piccole dimensioni in base al quale impostare il rientro di ListViewItem.
Index	Ottiene l'indice in base zero dell'elemento all'interno del ListView controllo .
ListView	Ottiene il ListView controllo che contiene l'elemento.
Name	Ottiene o imposta il nome associato all'oggetto ListViewItem.
Position	Ottiene o imposta la posizione dell'angolo superiore sinistro dell'oggetto ListViewItem.
Selected	Ottiene o imposta un valore che indica se l'elemento è selezionato.
StateImageIndex	Ottiene o imposta l'indice dell'immagine di stato (un'immagine come una casella di controllo selezionata o deselezionata che indica lo stato dell'elemento) visualizzata per l'elemento.
SubItems	Ottiene una raccolta contenente tutti gli elementi secondari dell'elemento.
Tag	Ottiene o imposta un oggetto che contiene dati da associare all'elemento.
Text	Ottiene o imposta il testo dell'elemento.
ToolTipText	Ottiene o imposta il testo visualizzato quando il puntatore del mouse si trova sull'oggetto ListViewItem.
UseItemStyleForSubItems	Ottiene o imposta un valore che indica se le Fontproprietà , ForeColore BackColor per l'elemento vengono utilizzate per tutti i relativi elementi secondari.

Metodi

Nome	Descrizione
BeginEdit()	Inserisce il testo dell'elemento in modalità di modifica.
Clone()	Crea una copia identica dell'elemento.
Deserialize(SerializationInfo, StreamingContext)	Deserializza l'elemento.
EnsureVisible()	Assicura che l'elemento sia visibile all'interno del controllo, scorrendo il contenuto del controllo, se necessario.
FindNearestItem(SearchDirectionHint)	Trova l'elemento successivo da ListViewItem, cercando nella direzione specificata.
GetBounds(ItemBoundsPortion)	Recupera la parte specificata del rettangolo di delimitazione per l'elemento.
GetSubItemAt(Int32, Int32)	Restituisce l'elemento secondario dell'oggetto ListViewItem in corrispondenza delle coordinate specificate.
Remove()	Rimuove l'elemento dal controllo associato ListView .
Serialize(SerializationInfo, StreamingContext)	Serializza l'elemento.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente.

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Serializza l'elemento.

Vedi anche

• ListView
• ListViewItem.ListViewSubItem
• Controllo ListView (Windows Form)