ListBox.TopIndex Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta l'indice del primo elemento visibile nel controllo ListBox.

public:
 property int TopIndex { int get(); void set(int value); };

[System.ComponentModel.Browsable(false)]
public int TopIndex { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.TopIndex : int with get, set

Public Property TopIndex As Integer

Valore della proprietà

Int32

Indice in base zero del primo elemento visibile del controllo.

Attributi

BrowsableAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare la proprietà con la SelectedIndexTopIndex proprietà per spostare l'elemento attualmente selezionato all'inizio dell'elenco di elementi nell'area di visualizzazione di ListBox. Nell'esempio viene inoltre illustrato come rimuovere elementi usando il RemoveAt metodo della System.Windows.Forms.ListBox.ObjectCollection classe e come cancellare tutte le selezioni di elementi usando il ClearSelected metodo . Il codice sposta innanzitutto l'elemento attualmente selezionato nell'oggetto ListBox all'inizio dell'elenco. Il codice rimuove quindi tutti gli elementi prima dell'elemento attualmente selezionato e cancella tutte le selezioni nell'oggetto ListBox. In questo esempio è necessario aggiungere un ListBox elemento contenitore a una maschera e che un elemento è attualmente selezionato in ListBox.

private:
   void RemoveTopItems()
   {
      // Determine if the currently selected item in the ListBox 
      // is the item displayed at the top in the ListBox.
      if ( listBox1->TopIndex != listBox1->SelectedIndex )

      // Make the currently selected item the top item in the ListBox.
      listBox1->TopIndex = listBox1->SelectedIndex;

      // Remove all items before the top item in the ListBox.
      for ( int x = (listBox1->SelectedIndex - 1); x >= 0; x-- )
      {
         listBox1->Items->RemoveAt( x );
      }

      // Clear all selections in the ListBox.
      listBox1->ClearSelected();
   }

private void RemoveTopItems()
{
   // Determine if the currently selected item in the ListBox 
   // is the item displayed at the top in the ListBox.
   if (listBox1.TopIndex != listBox1.SelectedIndex)
      // Make the currently selected item the top item in the ListBox.
      listBox1.TopIndex = listBox1.SelectedIndex;

   // Remove all items before the top item in the ListBox.
   for (int x = (listBox1.SelectedIndex -1); x >= 0; x--)
   {
      listBox1.Items.RemoveAt(x);
   }

   // Clear all selections in the ListBox.
   listBox1.ClearSelected();
}

Private Sub RemoveTopItems()
   ' Determine if the currently selected item in the ListBox 
   ' is the item displayed at the top in the ListBox.
   If listBox1.TopIndex <> listBox1.SelectedIndex Then
      ' Make the currently selected item the top item in the ListBox.
      listBox1.TopIndex = listBox1.SelectedIndex
   End If
   ' Remove all items before the top item in the ListBox.
   Dim x As Integer
   For x = listBox1.SelectedIndex - 1 To 0 Step -1
      listBox1.Items.RemoveAt(x)
   Next x

   ' Clear all selections in the ListBox.
   listBox1.ClearSelected()
End Sub

Commenti

Inizialmente, l'elemento con la posizione di indice zero (0) si trova nella parte superiore dell'area visibile dell'oggetto ListBox. Se il contenuto di ListBox è stato eseguito lo scorrimento, un altro elemento potrebbe trovarsi nella parte superiore dell'area di visualizzazione del controllo. È possibile utilizzare questa proprietà per ottenere l'indice all'interno ListBox.ObjectCollection dell'oggetto dell'elemento ListBox attualmente posizionato nella parte superiore dell'area visibile del controllo. È anche possibile utilizzare questa proprietà per posizionare un elemento nell'elenco nella parte superiore dell'area visibile del controllo.