Compartilhar via


DataGridViewColumn.HeaderText Propriedade

Definição

Obtém ou define o texto de legenda na célula do cabeçalho da coluna.

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

Valor da propriedade

Um String com o texto desejado. O padrão é uma cadeia de caracteres vazia ("").

Exemplos

O exemplo de código a seguir usa a HeaderText propriedade para alterar o texto no cabeçalho da coluna. Este exemplo de código faz parte de um exemplo maior fornecido para a 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

Comentários

Essa propriedade é útil somente quando a coluna tem uma célula de cabeçalho associada. Para obter mais informações, consulte a propriedade HeaderCellCore.

Observação

Não há nenhuma propriedade de texto de cabeçalho correspondente para linhas. Para exibir rótulos em cabeçalhos de linha, você deve manipular o DataGridView.CellPainting evento e pintar seus próprios rótulos quando DataGridViewCellPaintingEventArgs.ColumnIndex for -1.

Aplica-se a

Confira também