GridViewColumn.HeaderContainerStyle プロパティ

定義

GridViewColumn のヘッダーに使用するスタイルを取得または設定します。Gets or sets the style to use for the header of the GridViewColumn.

public:
 property System::Windows::Style ^ HeaderContainerStyle { System::Windows::Style ^ get(); void set(System::Windows::Style ^ value); };
public System.Windows.Style HeaderContainerStyle { get; set; }
member this.HeaderContainerStyle : System.Windows.Style with get, set
Public Property HeaderContainerStyle As Style

プロパティ値

列ヘッダーの表示プロパティを定義する StyleThe Style that defines the display properties for the column header. 既定では、 nullです。The default is null.

次の例は、列ヘッダーの表示プロパティを指定する HeaderContainerStyle を定義する方法を示しています。The following example shows how to define a HeaderContainerStyle that specifies display properties for a column header.

<Style x:Key="myHeaderStyle" TargetType="{x:Type GridViewColumnHeader}">
  <Setter Property="Background" Value="LightBlue"/>
</Style>
<GridViewColumn Header="Month" Width="80"
      HeaderContainerStyle="{StaticResource myHeaderStyle}"
      HeaderTemplate="{StaticResource myHeaderTemplate}"
      DisplayMemberBinding="{Binding Path=Month}"/>

次の例は、ControlTemplateを使用して表示プロパティを定義する HeaderContainerStyle を定義する方法を示しています。The following example shows how to define a HeaderContainerStyle that defines display properties by using a ControlTemplate.

<Style x:Key="myControlTemplateStyle" 
       TargetType="{x:Type GridViewColumnHeader}">
  <Setter Property="Template">
    <Setter.Value>
      <ControlTemplate TargetType="{x:Type GridViewColumnHeader}">
        <Grid Background="LightBlue">
          <DockPanel HorizontalAlignment="Center"
                      VerticalAlignment="Center">
            <CheckBox></CheckBox>
            <TextBlock Text="{TemplateBinding Content}" 
                  FontSize="16" Foreground="DarkBlue"/>
          </DockPanel>
          <Canvas>
          <Thumb x:Name="PART_HeaderGripper"
                 Style="{StaticResource GridViewColumnHeaderGripper}"
                 Background="Transparent"
                 />
        </Canvas>
        </Grid>
      </ControlTemplate>
    </Setter.Value>
  </Setter>
</Style>
<GridView ColumnHeaderContainerStyle="{StaticResource 
                       myControlTemplateStyle}">
  <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>

注釈

HeaderContainerStyle プロパティと HeaderTemplate プロパティを使用して、プロパティ値と、列ヘッダーコンテンツのビジュアルツリーをまとめることができます。The HeaderContainerStyle property and the HeaderTemplate property can together define property values and the visual tree for column header content. HeaderContainerStyle プロパティでは、ControlTemplateを定義することによってビジュアルツリーを指定することもできます。The HeaderContainerStyle property can also specify the visual tree by defining a ControlTemplate.

列ヘッダーのコンテンツ、レイアウト、およびスタイルを定義するプロパティは、関連する多くのクラスにあります。これらのプロパティの一部は、類似した機能または同じ機能を持っています。Properties that define the content, layout, and style of a column header are found in many related classes, and some of these properties have functionality that is similar or the same. 詳細については、GridView の列ヘッダーのスタイルとテンプレートの概要を参照してください。For more information, see GridView Column Header Styles and Templates Overview.

スタイルを設定すると、いくつかの制限が適用されます。When you set a style, some restrictions apply. 詳細については、「スタイルとテンプレート」を参照してください。For more information, see the Styling and Templating.

XAML 属性の使用XAML Attribute Usage

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

XAML プロパティ要素の使用XAML Property Element Usage

XAML の値XAML Values

ResourceExtensionResourceExtension
次のいずれか: StaticResource、または DynamicResourceOne of the following: StaticResource, or DynamicResource. XAML リソース」を参照してください。See XAML Resources.

StyleResourceKeyStyleResourceKey
要求されているスタイルを識別するキー。The key that identifies the style being requested. キーは、ResourceDictionary内の既存のリソースを参照します。The key refers to an existing resource in a ResourceDictionary.

注意

Property 要素の構文は技術的には可能ですが、推奨されません。Property element syntax is technically possible, but not recommended. インラインスタイルとテンプレート」を参照してください。See Inline Styles and Templates. またはを使用するバインディング参照も可能ですが、一般的ではありません。A binding reference using or is also possible, but uncommon.

依存プロパティ情報Dependency Property Information

識別子フィールドIdentifier field HeaderContainerStyleProperty
メタデータプロパティが true に設定されるMetadata properties set to true なしNone

適用対象

こちらもご覧ください