DataGridViewColumn.HeaderText Propiedad

Definición

Obtiene o establece el texto de título en la celda de encabezado de columna.Gets or sets the caption text on the column's header cell.

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 propiedad

String con el texto deseado.A String with the desired text. El valor predeterminado es una cadena vacía ("").The default is an empty string ("").

Ejemplos

En el ejemplo de código siguiente HeaderText se usa la propiedad para cambiar el texto del encabezado de columna.The following code example uses the HeaderText property to change the text in the column header. Este ejemplo de código forma parte de un ejemplo más extenso proporcionado DataGridViewColumn para la clase.This code example is part of a larger example provided for the DataGridViewColumn class.

// 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

Comentarios

Esta propiedad solo es útil cuando la columna tiene una celda de encabezado asociada.This property is useful only when the column has an associated header cell. Para obtener más información, vea la propiedad HeaderCellCore.For more information, see the HeaderCellCore property.

Nota

No hay ninguna propiedad de texto de encabezado correspondiente para las filas.There is no corresponding header text property for rows. Para mostrar las etiquetas en los encabezados de fila, debe controlar DataGridView.CellPainting el evento y pintar sus propias etiquetas DataGridViewCellPaintingEventArgs.ColumnIndex cuando sea-1.To display labels in row headers, you must handle the DataGridView.CellPainting event and paint your own labels when DataGridViewCellPaintingEventArgs.ColumnIndex is -1.

Se aplica a

Consulte también: