DataGridViewColumn.DisplayIndex Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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, setPublic Property DisplayIndex As IntegerValeur de propriété
Position de base zéro de la colonne telle qu’elle est affichée dans le -1 associé DataGridView, ou -1 si la bande n’est pas contenue dans un contrôle.
- Attributs
Exceptions
DataGridView n’est pas 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 dans le 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 échanger la position visuelle des premières et dernières colonnes. Notez que les insertions se produisent avant le 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, comme indiqué par l’interface utilisateur (UI). Par défaut, chaque colonne est définie sur le nombre d’ordre DisplayIndex croissant, ce qui reflète l’ordre dans lequel elles ont été ajoutées. La Visible valeur de 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 le GetFirstColumn, GetLastColumnou GetNextColumn la méthode de la DataGridViewColumnCollection classe.
Chaque colonne du contrôle a une valeur unique DisplayIndex . Les valeurs commencent par 0 et continuent 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.
