DataGridView.ColumnHeadersHeightSizeMode Property

 

Gets or sets a value indicating whether the height of the column headers is adjustable and whether it can be adjusted by the user or is automatically adjusted to fit the contents of the headers.

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

member ColumnHeadersHeightSizeMode : DataGridViewColumnHeadersHeightSizeMode with get, set

Property Value

Type: System.Windows.Forms.DataGridViewColumnHeadersHeightSizeMode

A DataGridViewColumnHeadersHeightSizeMode value indicating the mode by which the height of the column headers row can be adjusted. The default is EnableResizing.

Exception Condition
InvalidEnumArgumentException

The specified value when setting this property is not a valid DataGridViewColumnHeadersHeightSizeMode value.

When this property is set to AutoSize, the height of the column headers cannot be adjusted by the user.

To adjust the height of the column headers programmatically, use the AutoResizeColumnHeadersHeight method or set the ColumnHeadersHeight property.

To set the sizing mode for the row headers, use the RowHeadersWidthSizeMode property.

For cell contents to wrap onto multiple lines when the column headers are resized, the cell style in effect for the cell must have a WrapMode property value of True.

For more information about header sizing, see Sizing Options in the Windows Forms DataGridView Control.

System_CAPS_noteNote

The DataGridView control does not support double buffering. If DoubleBuffered is set to true in a derived DataGridView control, users will not receive visual feedback when resizing rows, columns, or headers or when reordering columns.

The following code example illustrates how to use this property in a DataGridView control intended primarily for display. In this example, the visual appearance of the control is customized in several ways and the control is configured for limited interactivity. This example is part of a larger example available in the DataGridViewCellStyle class overview.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 2.0
Return to top
Show: