DataGridViewColumn::HeaderText Property

 

Gets or sets the caption text on the column's header cell.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

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

Property Value

Type: System::String^

A String with the desired text. The default is an empty string ("").

This property is useful only when the column has an associated header cell. For more information, see the HeaderCellCore property.

System_CAPS_noteNote

There is no corresponding header text property for rows. To display labels in row headers, you must handle the DataGridView::CellPainting event and paint your own labels when DataGridViewCellPaintingEventArgs::ColumnIndex is -1.

The following code example uses the HeaderText property to change the text in the column header. 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() );
   }
}


.NET Framework
Available since 2.0
Return to top
Show: