ListBox.SelectedIndexCollection Classe

Definizione

Rappresenta la raccolta che contiene gli indici per gli elementi selezionati in un controllo ListBox.Represents the collection containing the indexes to the selected items in a ListBox.

public: ref class ListBox::SelectedIndexCollection : System::Collections::IList
public class ListBox.SelectedIndexCollection : System.Collections.IList
type ListBox.SelectedIndexCollection = class
    interface IList
    interface ICollection
    interface IEnumerable
Public Class ListBox.SelectedIndexCollection
Implements IList
Ereditarietà
ListBox.SelectedIndexCollection
Implementazioni

Esempi

Nell'esempio seguente viene illustrato come utilizzare il metodo FindString per cercare tutte le istanze del testo di ricerca negli elementi della ListBox.The following example demonstrates how to use the FindString method to search for all instances of the search text in the items of the ListBox. Nell'esempio viene utilizzata la versione del metodo FindString che consente di specificare un indice di ricerca iniziale da cui eseguire una ricerca continua di tutti gli elementi nel ListBox.The example uses the version of the FindString method that enables you to specify a starting search index from which to do a continual search of all items in the ListBox. Nell'esempio viene inoltre illustrato come determinare quando il metodo FindString inizia la ricerca dalla parte superiore dell'elenco dopo che ha raggiunto la fine dell'elenco di elementi per impedire una ricerca ricorsiva.The example also demonstrates how to determine when the FindString method begins searching from the top of the list after it reaches the bottom of the list of items to prevent a recursive search. Una volta trovati gli elementi nella ListBox, vengono selezionati usando il metodo SetSelected.Once items are found in the ListBox, they are selected using the SetSelected method.

private:
   void FindAllOfMyString( String^ searchString )
   {
      // Set the SelectionMode property of the ListBox to select multiple items.
      listBox1->SelectionMode = SelectionMode::MultiExtended;

      // Set our intial index variable to -1.
      int x = -1;

      // If the search string is empty exit.
      if ( searchString->Length != 0 )
      {
         // Loop through and find each item that matches the search string.
         do
         {
            // Retrieve the item based on the previous index found. Starts with -1 which searches start.
            x = listBox1->FindString( searchString, x );

            // If no item is found that matches exit.
            if ( x != -1 )
            {
               // Since the FindString loops infinitely, determine if we found first item again and exit.
               if ( listBox1->SelectedIndices->Count > 0 )
               {
                  if ( x == listBox1->SelectedIndices[ 0 ] )
                                    return;
               }

               // Select the item in the ListBox once it is found.
               listBox1->SetSelected( x, true );
            }
         }
         while ( x != -1 );
      }
   }
private void FindAllOfMyString(string searchString)
{
   // Set the SelectionMode property of the ListBox to select multiple items.
   listBox1.SelectionMode = SelectionMode.MultiExtended;
   
   // Set our intial index variable to -1.
   int x =-1;
   // If the search string is empty exit.
   if (searchString.Length != 0)
   {
      // Loop through and find each item that matches the search string.
      do
      {
         // Retrieve the item based on the previous index found. Starts with -1 which searches start.
         x = listBox1.FindString(searchString, x);
         // If no item is found that matches exit.
         if (x != -1)
         {
            // Since the FindString loops infinitely, determine if we found first item again and exit.
            if (listBox1.SelectedIndices.Count > 0)
            {
               if(x == listBox1.SelectedIndices[0])
                  return;
            }
            // Select the item in the ListBox once it is found.
            listBox1.SetSelected(x,true);
         }
      }while(x != -1);
   }
}
Private Sub FindAllOfMyString(ByVal searchString As String)
   ' Set the SelectionMode property of the ListBox to select multiple items.
   listBox1.SelectionMode = SelectionMode.MultiExtended

   ' Set our intial index variable to -1.
   Dim x As Integer = -1
   ' If the search string is empty exit.
   If searchString.Length <> 0 Then
      ' Loop through and find each item that matches the search string.
      Do
         ' Retrieve the item based on the previous index found. Starts with -1 which searches start.
         x = listBox1.FindString(searchString, x)
         ' If no item is found that matches exit.
         If x <> -1 Then
            ' Since the FindString loops infinitely, determine if we found first item again and exit.
            If ListBox1.SelectedIndices.Count > 0 Then
               If x = ListBox1.SelectedIndices(0) Then
                  Return
               End If
            End If
            ' Select the item in the ListBox once it is found.
            ListBox1.SetSelected(x, True)
         End If
      Loop While x <> -1
   End If
End Sub

Commenti

La classe ListBox.SelectedIndexCollection archivia gli indici negli elementi selezionati nel ListBox.The ListBox.SelectedIndexCollection class stores the indexes to the selected items in the ListBox. Gli indici archiviati nel ListBox.SelectedIndexCollection sono posizioni di indice all'interno della classe ListBox.ObjectCollection.The indexes stored in the ListBox.SelectedIndexCollection are index positions within the ListBox.ObjectCollection class. La classe ListBox.ObjectCollection archivia tutti gli elementi visualizzati nel ListBox.The ListBox.ObjectCollection class stores all items displayed in the ListBox.

Nella tabella seguente è riportato un esempio del modo in cui il ListBox.ObjectCollection archivia gli elementi del ListBox, nonché gli Stati di selezione in un ListBoxdi esempio.The following table is an example of how the ListBox.ObjectCollection stores the items of the ListBox as well as their selection states within an example ListBox.

IndiceIndex ElementoItem Stato di selezione all'interno della casella di riepilogoSelection state within the ListBox
00 Oggetto1object1 DeselezionatoUnselected
11 oggetto2object2 SelectedSelected
22 object3object3 DeselezionatoUnselected
33 object4object4 SelectedSelected
44 object5object5 SelectedSelected

Sulla base dell'esempio ListBox.ObjectCollection nella tabella precedente, nella tabella seguente viene illustrata la modalità di visualizzazione del ListBox.SelectedIndexCollection.Based on the ListBox.ObjectCollection example in the previous table, the following table demonstrates how the ListBox.SelectedIndexCollection would appear.

IndiceIndex Indice dell'elemento selezionato in ObjectCollectionIndex of selected item in ObjectCollection
00 11
11 33
22 44

È possibile utilizzare le proprietà e i metodi di questa classe per eseguire una serie di attività con la raccolta.You can use the properties and methods of this class to perform a variety of tasks with the collection. Il Contains metodo consente di determinare se una posizione di indice dalla classe ListBox.ObjectCollection è un membro degli indici selezionati archiviati nella ListBox.SelectedIndexCollection.The Contains method enables you to determine whether an index position from the ListBox.ObjectCollection class is a member of the selected indexes stored in the ListBox.SelectedIndexCollection. Quando si è certi che l'elemento si trova all'interno della raccolta, è possibile usare il metodo IndexOf per determinare il punto in cui viene archiviata una posizione di indice specifica all'interno dell'ListBox.ObjectCollection per il ListBox.Once you know that the item is located within the collection, you can use the IndexOf method to determine where a specific index position within the ListBox.ObjectCollection for the ListBox is stored.

Costruttori

ListBox.SelectedIndexCollection(ListBox)

Inizializza una nuova istanza della classe ListBox.SelectedIndexCollection.Initializes a new instance of the ListBox.SelectedIndexCollection class.

Proprietà

Count

Ottiene il numero di elementi inclusi nella raccolta.Gets the number of items in the collection.

IsReadOnly

Ottiene un valore che indica se la raccolta è di sola lettura.Gets a value indicating whether the collection is read-only.

Item[Int32]

Ottiene il valore dell'indice in corrispondenza dell'indice specificato all'interno dell'insieme.Gets the index value at the specified index within this collection.

Metodi

Add(Int32)

Aggiunge l'oggetto ListBox nella posizione di indice specificata.Adds the ListBox at the specified index location.

Clear()

Rimuove tutti i controlli dall'insieme.Removes all controls from the collection.

Contains(Int32)

Determina se l'indice specificato si trova all'interno dell'insieme.Determines whether the specified index is located within the collection.

CopyTo(Array, Int32)

Copia l'intero insieme in una posizione specifica all'interno di una matrice esistente.Copies the entire collection into an existing array at a specified location within the array.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetEnumerator()

Restituisce un enumeratore da utilizzare per scorrere l'insieme degli indici selezionato.Returns an enumerator to use to iterate through the selected indexes collection.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
IndexOf(Int32)

Restituisce l'indice all'interno dell'insieme ListBox.SelectedIndexCollection dell'indice specificato dalla classe ListBox.ObjectCollection del controllo ListBox.Returns the index within the ListBox.SelectedIndexCollection of the specified index from the ListBox.ObjectCollection of the ListBox.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
Remove(Int32)

Rimuove il controllo specificato dall'insieme.Removes the specified control from the collection.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

ICollection.IsSynchronized

Per una descrizione di questo membro, vedere IsSynchronized.For a description of this member, see IsSynchronized.

ICollection.SyncRoot

Per una descrizione di questo membro, vedere SyncRoot.For a description of this member, see SyncRoot.

IList.Add(Object)

Per una descrizione di questo membro, vedere Add(Object).For a description of this member, see Add(Object).

IList.Clear()

Per una descrizione di questo membro, vedere Clear().For a description of this member, see Clear().

IList.Contains(Object)

Per una descrizione di questo membro, vedere Contains(Object).For a description of this member, see Contains(Object).

IList.IndexOf(Object)

Per una descrizione di questo membro, vedere IndexOf(Object).For a description of this member, see IndexOf(Object).

IList.Insert(Int32, Object)

Per una descrizione di questo membro, vedere Insert(Int32, Object).For a description of this member, see Insert(Int32, Object).

IList.IsFixedSize

Per una descrizione di questo membro, vedere IsFixedSize.For a description of this member, see IsFixedSize.

IList.Item[Int32]

Per una descrizione di questo membro, vedere Item[Int32].For a description of this member, see Item[Int32].

IList.Remove(Object)

Per una descrizione di questo membro, vedere Remove(Object).For a description of this member, see Remove(Object).

IList.RemoveAt(Int32)

Per una descrizione di questo membro, vedere RemoveAt(Int32).For a description of this member, see RemoveAt(Int32).

Metodi di estensione

Cast<TResult>(IEnumerable)

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Consente la parallelizzazione di una query.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte un oggetto IEnumerable in un oggetto IQueryable.Converts an IEnumerable to an IQueryable.

Si applica a