ListBox.TopIndex Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece el índice del primer elemento visible del control 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

Valor de propiedad

Int32

Índice de base cero del primer elemento visible del control.

Atributos

BrowsableAttribute

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la SelectedIndex propiedad con la TopIndex propiedad para mover el elemento seleccionado actualmente a la parte superior de la lista de elementos del área de presentación de ListBox. En el ejemplo se muestra cómo quitar elementos mediante el RemoveAt método de la System.Windows.Forms.ListBox.ObjectCollection clase y cómo borrar toda la selección de elementos mediante el ClearSelected método . El código mueve primero el elemento seleccionado actualmente en la ListBox parte superior de la lista. A continuación, el código quita todos los elementos antes del elemento seleccionado actualmente y borra todas las selecciones de .ListBox En este ejemplo se requiere que se agregue un ListBox elemento contenedor a un formulario y que un elemento esté seleccionado actualmente en .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

Comentarios

Inicialmente, el elemento con la posición de índice cero (0) está en la parte superior de la región visible de ListBox. Si el contenido de ListBox se ha desplazado, otro elemento podría estar en la parte superior del área de visualización del control. Puede usar esta propiedad para obtener el índice dentro ListBox.ObjectCollection del objeto ListBox del elemento situado actualmente en la parte superior de la región visible del control. También puede usar esta propiedad para colocar un elemento en la lista en la parte superior de la región visible del control.