DataGridViewColumn.DisplayIndex Propiedad

Definición

Obtiene o establece el orden de presentación de la columna respecto de las columnas actualmente mostradas.Gets or sets the display order of the column relative to the currently displayed columns.

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

Valor de propiedad

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.The zero-based position of the column as it is displayed in the associated DataGridView, or -1 if the band is not contained within a control.

Atributos

Excepciones

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.DataGridView is not null and the specified value when setting this property is less than 0 or greater than or equal to the number of columns in the control.

O bien,-or- DataGridView es null y el valor especificado al establecer esta propiedad es menor que -1.DataGridView is null and the specified value when setting this property is less than -1.

O bien,-or- El valor especificado al establecer esta propiedad es igual que MaxValue.The specified value when setting this property is equal to MaxValue.

Ejemplos

En el ejemplo de código siguiente se usa la propiedad DisplayIndex para intercambiar la posición visual de la primera y la última columna.The following code example uses the DisplayIndex property to swap the visual position of the first and last columns. Tenga en cuenta que las inserciones se producen antes de la DisplayIndex.Note that insertions occur before the DisplayIndex. Este ejemplo de código forma parte de un ejemplo más extenso proporcionado para la clase DataGridViewColumn.This code example is part of a larger example provided for the DataGridViewColumn class.

// 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 propiedad Index, la propiedad DisplayIndex corresponde a la posición actual de la columna tal y como se muestra en la interfaz de usuario (UI).Unlike the Index property, the DisplayIndex property corresponds to the current position of the column as displayed by the user interface (UI). De forma predeterminada, la DisplayIndex de cada columna se establece en números de orden ascendente, lo que refleja el orden en el que se agregaron.By default, each column's DisplayIndex is set to numbers of increasing order, which reflects the order in which they were added. El valor de la propiedad Visible no afecta al valor de DisplayIndex.The Visible property value does not affect the DisplayIndex value. Para determinar la posición de la presentación de una columna en función de su visibilidad u otro Estado, utilice el método GetFirstColumn, GetLastColumno GetNextColumn de la clase DataGridViewColumnCollection.To determine the display position of a column based on its visibility or other state, use the GetFirstColumn, GetLastColumn, or GetNextColumn method of the DataGridViewColumnCollection class.

Cada columna del control tiene un valor de DisplayIndex único.Every column in the control has a unique DisplayIndex value. Los valores empiezan por 0 y continúan en orden numérico sin omitir ningún valor.The values start with 0 and proceed in numerical order without skipping any values. Al cambiar el valor de DisplayIndex de una columna, se cambian los valores DisplayIndex de otras columnas para reflejar el nuevo pedido.When you change the DisplayIndex value for a column, the DisplayIndex values for other columns are changed to reflect the new order.

Si la columna tiene un control DataGridView asociado, el establecimiento de esta propiedad hará que el control se vuelva a dibujar.If the column has an associated DataGridView control, setting this property will cause the control to redraw itself.

Se aplica a

Consulte también: