DataGridViewBand.Index 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 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é
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
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.