DataGridViewColumn.DisplayIndex Propriété

Définition

Obtient ou définit l'ordre d'affichage de la colonne par rapport aux colonnes actuellement affichées.

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

Valeur de propriété

Int32

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.

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.

  • ou - DataGridView est null, et la valeur spécifiée lors de la définition de cette propriété est inférieure à -1.

  • ou - La valeur spécifiée lors de la définition de cette propriété est égale à MaxValue.

Exemples

L’exemple de code suivant utilise la DisplayIndex propriété pour permuter la position visuelle des première et dernière colonnes. Notez que les insertions se produisent avant le DisplayIndex . Cet exemple de code fait partie d’un exemple plus complet fourni pour la DataGridViewColumn classe.

// 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é, la DisplayIndex propriété correspond à la position actuelle de la colonne telle qu’elle est affichée par l’interface utilisateur. Par défaut, chaque colonne DisplayIndex est définie sur un nombre croissant d’ordre, ce qui reflète l’ordre dans lequel ils ont été ajoutés. La Visible valeur de la propriété n’affecte pas la DisplayIndex valeur. Pour déterminer la position d’affichage d’une colonne en fonction de sa visibilité ou d’un autre État, utilisez la GetFirstColumn GetLastColumn méthode, ou GetNextColumn de la DataGridViewColumnCollection classe.

Chaque colonne du contrôle a une valeur unique DisplayIndex . Les valeurs commencent par 0 et suivent l’ordre numérique sans ignorer les valeurs. Lorsque vous modifiez la DisplayIndex valeur d’une colonne, les DisplayIndex valeurs des autres colonnes sont modifiées pour refléter la nouvelle commande.

Si la colonne possède un DataGridView contrôle associé, la définition de cette propriété entraîne le redessin du contrôle.

S’applique à

Voir aussi