DataGridViewBand.Index Propriété

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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 la position relative de la bande dans le contrôle DataGridView.

public:
 property int Index { int get(); };

[System.ComponentModel.Browsable(false)]
public int Index { get; }

[<System.ComponentModel.Browsable(false)>]
member this.Index : int

Public ReadOnly Property Index As Integer

Valeur de propriété

Int32

Position de base zéro de la bande dans le DataGridViewRowCollection ou le DataGridViewColumnCollection dans lequel il est contenu. La valeur par défaut est -1, indiquant qu'il n'existe aucun contrôle DataGridView associé.

Attributs: BrowsableAttribute

Exemples

L’exemple de code suivant utilise la Index propriété pour définir des étiquettes de colonne. La propriété de la Index bande est accessible par le biais d’un DataGridViewColumn.

Notes

Si les styles visuels sont activés, le thème actuel remplace les propriétés de style d’affichage pour les en-têtes de ligne et de colonne.

// Style and number columns.
void Button8_Click( Object^ /*sender*/, EventArgs^ /*args*/ )
{
   DataGridViewCellStyle^ style = gcnew DataGridViewCellStyle;
   style->Alignment = DataGridViewContentAlignment::MiddleCenter;
   style->ForeColor = Color::IndianRed;
   style->BackColor = Color::Ivory;
   IEnumerator^ myEnum1 = dataGridView->Columns->GetEnumerator();
   while ( myEnum1->MoveNext() )
   {
      DataGridViewColumn^ column = safe_cast<DataGridViewColumn^>(myEnum1->Current);
      column->HeaderCell->Value = column->Index.ToString();
      column->HeaderCell->Style = style;
   }
}

// Style and number columns.
private void Button8_Click(object sender,
    EventArgs args)
{
    DataGridViewCellStyle style = new DataGridViewCellStyle();
    style.Alignment =
        DataGridViewContentAlignment.MiddleCenter;
    style.ForeColor = Color.IndianRed;
    style.BackColor = Color.Ivory;

    foreach (DataGridViewColumn column in dataGridView.Columns)
    {
        column.HeaderCell.Value = column.Index.ToString();
        column.HeaderCell.Style = style;
    }
}

' Style and number columns.
Private Sub Button8_Click(ByVal sender As Object, _
    ByVal args As EventArgs) Handles Button8.Click

    Dim style As DataGridViewCellStyle = _
        New DataGridViewCellStyle()
    style.Alignment = _
        DataGridViewContentAlignment.MiddleCenter
    style.ForeColor = Color.IndianRed
    style.BackColor = Color.Ivory

    For Each column As DataGridViewColumn _
        In dataGridView.Columns

        column.HeaderCell.Value = _
            column.Index.ToString
        column.HeaderCell.Style = style
    Next
End Sub

Remarques

La valeur de cette propriété ne correspond pas nécessairement à la position visuelle actuelle de la bande dans la collection. Par exemple, si l’utilisateur réorganise les colonnes dans un DataGridView moment de l’exécution (en supposant que la AllowUserToOrderColumns propriété est définie sur true), la valeur de la Index propriété de chaque colonne ne change pas. Au lieu de cela, les valeurs de colonne DisplayIndex changent. Toutefois, le tri des lignes change leurs Index valeurs.

S’applique à

Partager via