DataGridViewColumn.HeaderText Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

DataGridViewColumn.cs

Obtient ou définit le texte de légende dans la cellule d’en-tête de la colonne.

public:
 property System::String ^ HeaderText { System::String ^ get(); void set(System::String ^ value); };

public string HeaderText { get; set; }

member this.HeaderText : string with get, set

Public Property HeaderText As String

Valeur de propriété

String

Avec String le texte souhaité. La valeur par défaut est une chaîne vide ( » « ).

Exemples

L’exemple de code suivant utilise la HeaderText propriété pour modifier le texte dans l’en-tête de colonne. Cet exemple de code fait partie d’un exemple plus grand fourni pour la DataGridViewColumn classe.

// Change the text in the column header.
void Button9_Click( Object^ /*sender*/, EventArgs^ /*args*/ )
{
   IEnumerator^ myEnum2 = dataGridView->Columns->GetEnumerator();
   while ( myEnum2->MoveNext() )
   {
      DataGridViewColumn^ column = safe_cast<DataGridViewColumn^>(myEnum2->Current);
      column->HeaderText = String::Concat( L"Column ", column->Index.ToString() );
   }
}

// Change the text in the column header.
private void Button9_Click(object sender,
    EventArgs args)
{
    foreach (DataGridViewColumn column in dataGridView.Columns)
    {

        column.HeaderText = String.Concat("Column ",
            column.Index.ToString());
    }
}

' Change the text in the column header.
Private Sub Button9_Click(ByVal sender As Object, _
    ByVal args As EventArgs) Handles Button9.Click

    For Each column As DataGridViewColumn _
        In dataGridView.Columns

        column.HeaderText = String.Concat("Column ", _
            column.Index.ToString)
    Next
End Sub

Remarques

Cette propriété est utile uniquement lorsque la colonne a une cellule d’en-tête associée. Pour plus d’informations, consultez la propriété HeaderCellCore.

Note

Il n’existe aucune propriété de texte d’en-tête correspondante pour les lignes. Pour afficher les étiquettes dans les en-têtes de ligne, vous devez gérer l’événement DataGridView.CellPainting et peindre vos propres étiquettes quand est DataGridViewCellPaintingEventArgs.ColumnIndex -1.

Voir aussi

• DataGridView
• HeaderCellCore