GridView.ColumnHeaderContainerStyle Property

Reference

Definition

Namespace:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets the style to apply to column headers.

public:
 property System::Windows::Style ^ ColumnHeaderContainerStyle { System::Windows::Style ^ get(); void set(System::Windows::Style ^ value); };

public System.Windows.Style ColumnHeaderContainerStyle { get; set; }

member this.ColumnHeaderContainerStyle : System.Windows.Style with get, set

Public Property ColumnHeaderContainerStyle As Style

Property Value

Style

The Style that is used to define the display properties for column headers. The default value is null.

Examples

The following example shows how to define the ColumnHeaderContainerStyle property.

<Style x:Key="myHeaderStyle" TargetType="{x:Type GridViewColumnHeader}">
  <Setter Property="Background" Value="LightBlue"/>
</Style>

<GridView ColumnHeaderTemplate="{StaticResource myHeaderTemplate}"
          ColumnHeaderContainerStyle="{StaticResource myHeaderStyle}">
  <GridViewColumn Header="Year" Width="80"
        CellTemplate="{StaticResource myCellTemplateYear}"/>
  <GridViewColumn Header="Month" Width="80"
        CellTemplate="{StaticResource myCellTemplateMonth}"/>
  <GridViewColumn Header="Day" Width="80"
        CellTemplate="{StaticResource myCellTemplateDay}"/>
</GridView>

Remarks

The ColumnHeaderContainerStyle property and the ColumnHeaderTemplate property are both used to define the visual tree for the GridViewColumnHeader objects that represent the column headers in a GridView. The ColumnHeaderContainerStyle property can also define column header content when a ColumnHeaderTemplate is not by specified by defining a ControlTemplate for the GridViewColumnHeader object.

This property represents one of several ways to lay out and style column headers. For more information, see GridView Column Header Styles and Templates Overview.

When you set styles, there are some restrictions. For more information, see Styling and Templating.

XAML Attribute Usage

<object ColumnHeaderContainerStyle="{ResourceExtension StyleResourceKey}"/>

XAML Property Element Usage

XAML Values

ResourceExtension One of the following: StaticResource, or DynamicResource. See XAML Resources.

StyleResourceKey The key that identifies the style being requested. The key refers to an existing resource in a ResourceDictionary.

Note

Property element syntax is technically possible, but not recommended. See Inline Styles and Templates. A binding reference using TemplateBinding or is also possible, but uncommon.

Dependency Property Information

Item	Value
Identifier field	ColumnHeaderContainerStyleProperty
Metadata properties set to `true`	None

Applies to

Jaa