DataGridViewColumn.DisplayIndex Propriété

Définition

Obtient ou définit l'ordre d'affichage de la colonne par rapport aux colonnes actuellement affichées.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

Valeur de propriété

Position de base zéro de la colonne telle qu'elle est affichée dans le DataGridView associé, ou -1 si la bande n'est pas contenue dans un contrôle.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.

Attributs

Exceptions

DataGridView n'a pas la valeur null, et la valeur spécifiée lors de la définition de cette propriété est inférieure à 0 ou supérieure ou égale au nombre de colonnes du contrôle.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.

- ou --or- DataGridView est null, et la valeur spécifiée lors de la définition de cette propriété est inférieure à -1.DataGridView is null and the specified value when setting this property is less than -1.

- ou --or- La valeur spécifiée lors de la définition de cette propriété est égale à MaxValue.The specified value when setting this property is equal to MaxValue.

Exemples

L’exemple de code suivant utilise DisplayIndex la propriété pour permuter la position visuelle des première et dernière colonnes.The following code example uses the DisplayIndex property to swap the visual position of the first and last columns. Notez que les insertions se DisplayIndexproduisent avant le.Note that insertions occur before the DisplayIndex. Cet exemple de code fait partie d’un exemple plus complet fourni DataGridViewColumn pour la classe.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

Remarques

Contrairement à Index la propriété, DisplayIndex la propriété correspond à la position actuelle de la colonne telle qu’elle est affichée par l’interface utilisateur.Unlike the Index property, the DisplayIndex property corresponds to the current position of the column as displayed by the user interface (UI). Par défaut, chaque colonne est DisplayIndex définie sur un nombre croissant d’ordre, ce qui reflète l’ordre dans lequel ils ont été ajoutés.By default, each column's DisplayIndex is set to numbers of increasing order, which reflects the order in which they were added. La Visible valeur de la propriété n’affecte DisplayIndex pas la valeur.The Visible property value does not affect the DisplayIndex value. Pour déterminer la position d’affichage d’une colonne en fonction de sa visibilité ou d’un autre GetFirstColumnétat GetLastColumn, utilisez GetNextColumn la méthode, DataGridViewColumnCollection ou de la classe.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.

Chaque colonne du contrôle a une valeur unique DisplayIndex .Every column in the control has a unique DisplayIndex value. Les valeurs commencent par 0 et suivent l’ordre numérique sans ignorer les valeurs.The values start with 0 and proceed in numerical order without skipping any values. Lorsque vous modifiez la DisplayIndex valeur d’une colonne, les DisplayIndex valeurs des autres colonnes sont modifiées pour refléter la nouvelle commande.When you change the DisplayIndex value for a column, the DisplayIndex values for other columns are changed to reflect the new order.

Si la colonne possède un contrôle DataGridView associé, la définition de cette propriété entraîne le redessin du contrôle.If the column has an associated DataGridView control, setting this property will cause the control to redraw itself.

S’applique à

Voir aussi