DataGridViewColumn.HeaderText Propriedade

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

Recebe ou define o texto da 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 de Propriedade

String

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

Exemplos

O seguinte exemplo de código 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

Observações

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

Note

Não existe uma propriedade correspondente de texto de cabeçalho para linhas. Para exibir etiquetas em cabeçalhos de linha, deve tratar do DataGridView.CellPainting evento e pintar as suas próprias etiquetas quando DataGridViewCellPaintingEventArgs.ColumnIndex é -1.

Aplica-se a

Ver também