DataGridViewColumn.DisplayIndex Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Obtiene o establece el orden de presentación de la columna respecto de las columnas actualmente mostradas.

public:
 property int DisplayIndex { int get(); void set(int value); };
[System.ComponentModel.Browsable(false)]
public int DisplayIndex { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.DisplayIndex : int with get, set
Public Property DisplayIndex As Integer

Valor de propiedad

Int32

Posición de base cero de la columna tal como se muestra en el control DataGridView asociado, o -1 si la banda no está incluida en un control.

Atributos
BrowsableAttribute

Excepciones

ArgumentOutOfRangeException

DataGridView no es null y el valor especificado al establecer esta propiedad es menor que 0 o mayor o igual que el número de columnas del control.

o bien

DataGridView es null y el valor especificado al establecer esta propiedad es menor que -1.

o bien

El valor especificado al establecer esta propiedad es igual a Int32.MaxValue.

Ejemplos

En el ejemplo de código siguiente se usa la DisplayIndex propiedad para intercambiar la posición visual de las columnas primera y última. Tenga en cuenta que las inserciones se producen antes de DisplayIndex. Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase DataGridViewColumn.

// Swap the last column with the first.
void Button10_Click( Object^ /*sender*/, EventArgs^ /*args*/ )
{
   DataGridViewColumnCollection^ columnCollection = dataGridView->Columns;
   DataGridViewColumn^ firstDisplayedColumn = columnCollection->GetFirstColumn( DataGridViewElementStates::Visible );
   DataGridViewColumn^ lastDisplayedColumn = columnCollection->GetLastColumn( DataGridViewElementStates::Visible, DataGridViewElementStates::None );
   int firstColumn_sIndex = firstDisplayedColumn->DisplayIndex;
   firstDisplayedColumn->DisplayIndex = lastDisplayedColumn->DisplayIndex;
   lastDisplayedColumn->DisplayIndex = firstColumn_sIndex;
}

// Swap the last column with the first.
private void Button10_Click(object sender, EventArgs args)
{
    DataGridViewColumnCollection columnCollection = dataGridView.Columns;

    DataGridViewColumn firstVisibleColumn =
        columnCollection.GetFirstColumn(DataGridViewElementStates.Visible);
    DataGridViewColumn lastVisibleColumn =
        columnCollection.GetLastColumn(
            DataGridViewElementStates.Visible, DataGridViewElementStates.None);

    int firstColumn_sIndex = firstVisibleColumn.DisplayIndex;
    firstVisibleColumn.DisplayIndex = lastVisibleColumn.DisplayIndex;
    lastVisibleColumn.DisplayIndex = firstColumn_sIndex;
}

' Swap the last column with the first.
Private Sub Button10_Click(ByVal sender As Object, _
    ByVal args As EventArgs) Handles Button10.Click

    Dim columnCollection As DataGridViewColumnCollection = _
        dataGridView.Columns

    Dim firstVisibleColumn As DataGridViewColumn = _
        columnCollection.GetFirstColumn(DataGridViewElementStates.Visible)
    Dim lastVisibleColumn As DataGridViewColumn = _
        columnCollection.GetLastColumn(DataGridViewElementStates.Visible, _
        Nothing)

    Dim firstColumn_sIndex As Integer = firstVisibleColumn.DisplayIndex
    firstVisibleColumn.DisplayIndex = _
        lastVisibleColumn.DisplayIndex
    lastVisibleColumn.DisplayIndex = firstColumn_sIndex
End Sub

Comentarios

A diferencia de la Index propiedad , la DisplayIndex propiedad corresponde a la posición actual de la columna tal como se muestra en la interfaz de usuario (UI). De forma predeterminada, el de DisplayIndex cada columna se establece en números de orden creciente, que refleja el orden en el que se agregaron. El Visible valor de la propiedad no afecta al DisplayIndex valor. Para determinar la posición de visualización de una columna en función de su visibilidad u otro estado, use el GetFirstColumnmétodo , GetLastColumno GetNextColumn de la DataGridViewColumnCollection clase .

Cada columna del control tiene un valor único DisplayIndex . Los valores comienzan por 0 y continúan en orden numérico sin omitir ningún valor. Al cambiar el DisplayIndex valor de una columna, los DisplayIndex valores de otras columnas se cambian para reflejar el nuevo orden.

Si la columna tiene un control asociado DataGridView , establecer esta propiedad hará que el control se vuelva a dibujar.

Se aplica a

Consulte también