DataGridViewColumn.HeaderText Свойство

Определение

Возвращает или задает текст ячейки заголовка столбца.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

Значение свойства

Строка типа String, содержащая требуемый текст.A String with the desired text. Значение по умолчанию — пустая строка ("").The default is an empty string ("").

Примеры

В следующем примере кода HeaderText свойство используется для изменения текста в заголовке столбца.The following code example uses the HeaderText property to change the text in the column header. Этот пример кода является частью большого примера, DataGridViewColumn приведенного для класса.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

Комментарии

Это свойство полезно только в том случае, если у столбца есть связанная ячейка заголовка.This property is useful only when the column has an associated header cell. Дополнительные сведения см. в описании свойства HeaderCellCore.For more information, see the HeaderCellCore property.

Примечание

Нет соответствующего свойства текста заголовка для строк.There is no corresponding header text property for rows. Чтобы отобразить метки в заголовках строк, необходимо обрабатывать DataGridView.CellPainting событие и закрашивать собственные метки, если DataGridViewCellPaintingEventArgs.ColumnIndex значение равно-1.To display labels in row headers, you must handle the DataGridView.CellPainting event and paint your own labels when DataGridViewCellPaintingEventArgs.ColumnIndex is -1.

Применяется к

Дополнительно