This documentation is archived and is not being maintained.

DataGridView.EnableHeadersVisualStyles Property

Note: This property is new in the .NET Framework version 2.0.

Gets or sets a value indicating whether row and column headers use the visual styles of the user's current theme if visual styles are enabled for the application.

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

public bool EnableHeadersVisualStyles { get; set; }
/** @property */
public boolean get_EnableHeadersVisualStyles ()

/** @property */
public void set_EnableHeadersVisualStyles (boolean value)

public function get EnableHeadersVisualStyles () : boolean

public function set EnableHeadersVisualStyles (value : boolean)

Property Value

true if visual styles are enabled for the headers; otherwise, false.

You can enable visual styles for your application by calling the Application.EnableVisualStyles method before calling the System.Windows.Forms.Application.Run method. If EnableHeadersVisualStyles is set to true, all header cells except the TopLeftHeaderCell are painted using the current theme.

The following code example demonstrates how to disable visual styles for the row and column headers in an application that has visual styles enabled. In this example, visual styles have been enabled for the application by calling the EnableVisualStyles method in Main. However, visual styles will not be applied to the row and column headers because EnableHeadersVisualStyles is set to false. This code example is part of a larger example provided for the DataGridViewAdvancedBorderStyle class.

public CustomDataGridView()
    this.RowTemplate = new DataGridViewCustomRow();
    this.Columns.Add(new DataGridViewCustomColumn());
    this.Columns.Add(new DataGridViewCustomColumn());
    this.Columns.Add(new DataGridViewCustomColumn());
    this.RowCount = 4;
    this.EnableHeadersVisualStyles = false;
    this.AutoSize = true;

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0