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

Значение свойства

Стиль Style, определяющий свойства отображения для заголовка столбца.The 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}"/>

В следующем примере показано HeaderContainerStyle , как определить, определяющее свойства отображения с ControlTemplateпомощью.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. Свойство также может указывать визуальное дерево путем ControlTemplateопределения. HeaderContainerStyleThe 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.

Использование атрибута XAMLXAML Attribute Usage

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

Использование элемента свойства XAMLXAML Property Element Usage

Значения XAMLXAML Values

ресаурцеекстенсионResourceExtension
Один из следующих элементов: StaticResourceили. DynamicResourceOne of the following: StaticResource, or DynamicResource. См. раздел ресурсы XAML.See XAML Resources.

стилересаурцекэйStyleResourceKey
Ключ, определяющий запрашиваемый стиль.The key that identifies the style being requested. Ключ ссылается на существующий ресурс в ResourceDictionary.The key refers to an existing resource in a ResourceDictionary.

Примечание

Синтаксис элемента свойства технически возможен, но не рекомендуется.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
Свойства метаданных, для которых задано значениеtrueMetadata properties set to true НетNone

Применяется к

Дополнительно