DataGridViewColumn.DisplayIndex Propriété

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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
BrowsableAttribute

Exceptions

ArgumentOutOfRangeException

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 à Int32.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 .DisplayIndex Cet exemple de code fait partie d’un exemple plus grand 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 à la Index propriété, la DisplayIndex propriété correspond à la position actuelle de la colonne, telle qu’affichée par l’interface utilisateur . Par défaut, chaque colonne DisplayIndex est définie sur des nombres d’ordre croissant, ce qui reflète l’ordre dans lequel elles ont été ajoutées. 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 GetFirstColumnméthode , GetLastColumnou GetNextColumn de la DataGridViewColumnCollection classe .

Chaque colonne du contrôle a une valeur unique DisplayIndex . Les valeurs commencent par 0 et se poursuivent dans 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 le nouvel ordre.

Si la colonne a un contrôle associé DataGridView , la définition de cette propriété entraîne le redessinage du contrôle lui-même.

S’applique à

Voir aussi