ListViewItem Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta un elemento in un controllo 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

Ereditarietà: Object
ListViewItem

Attributi: TypeConverterAttribute SerializableAttribute

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. L'esempio crea ColumnHeader anche 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 per la creazione del ListView controllo :

È necessario aggiungere il codice a e Form chiamare il metodo creato nell'esempio dal costruttore o da un altro metodo nel form. L'esempio richiede che le immagini denominate MySmallImage1, MySmallImage2``MyLargeImage1, 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 un ListBox in in che 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 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 sottoelemento.

La maggior parte delle proprietà della ListViewItem classe consente di modificare la visualizzazione dell'elemento nel ListView controllo a cui è associata. 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 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 oppure 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 vengono 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 ListViewItem classe sono versioni specifiche degli elementi 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 dei 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

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

Proprietà

BackColor	Ottiene o imposta il colore di sfondo del testo dell'elemento.
Bounds	Ottiene il rettangolo di delimitazione dell'elemento, inclusi i relativi 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 dispone dello stato attivo all'interno del controllo ListView.
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 cui è assegnato l'elemento.
ImageIndex	Ottiene o imposta l'indice dell'immagine associata all'elemento.
ImageKey	Ottiene o imposta la chiave dell'immagine visualizzata per l'elemento.
ImageList	Ottiene l'oggetto ImageList contenente l'immagine associata all'elemento.
IndentCount	Ottiene o imposta il valore della larghezza delle immagini piccole con cui effettuare il rientro dell'oggetto ListViewItem.
Index	Ottiene l'indice in base zero dell'elemento all'interno del controllo ListView.
ListView	Ottiene il controllo ListView contenente l'elemento.
Name	Ottiene o imposta il nome associato a questo 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 visualizzata per l'elemento, ossia un'immagine quale una casella di controllo selezionata o deselezionata che indica lo stato di un elemento.
SubItems	Ottiene un insieme contenente tutti gli elementi secondari dell'elemento.
Tag	Ottiene o imposta un oggetto contenente i 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 ferma sull'oggetto ListViewItem.
UseItemStyleForSubItems	Ottiene o imposta un valore che indica se le proprietà Font, ForeColor e BackColor dell'elemento vengono applicate anche ai rispettivi elementi secondari.

Metodi

BeginEdit()	Attiva la modalità di modifica per il testo dell'elemento.
Clone()	Crea una copia identica dell'elemento.
Deserialize(SerializationInfo, StreamingContext)	Deserializza l'elemento.
EnsureVisible()	Garantisce che l'elemento sia visualizzabile all'interno del controllo, se necessario, scorrendo il contenuto del controllo.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FindNearestItem(SearchDirectionHint)	Individua l'elemento successivo nell'oggetto ListViewItem, cercando nella direzione indicata.
GetBounds(ItemBoundsPortion)	Recupera la parte specificata del rettangolo di delimitazione per l'elemento.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetSubItemAt(Int32, Int32)	Restituisce l'elemento secondario dell'oggetto ListViewItem in corrispondenza delle coordinate specificate.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Remove()	Rimuove l'elemento dal relativo controllo ListView associato.
Serialize(SerializationInfo, StreamingContext)	Serializza l'elemento.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente.

Implementazioni dell'interfaccia esplicita

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Serializza l'elemento.

Si applica a