HeaderedItemsControl.HeaderTemplate Свойство

Определение

Возвращает или задает шаблон, используемый для отображения содержимого заголовка элемента управления.

[System.ComponentModel.Bindable(true)]
public System.Windows.DataTemplate HeaderTemplate { get; set; }

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

Шаблон данных, используемый для отображения заголовка элемента управления. Значение по умолчанию — null.

Атрибуты

Примеры

В следующем примере показано, как создать и использовать шаблон заголовка для указания внешнего вида заголовка.

<!--Define a control template for a HeaderedItemsControl-->
<Style TargetType="HeaderedItemsControl">
  <Setter Property="Template">
    <Setter.Value>
      <ControlTemplate TargetType="{x:Type HeaderedItemsControl}">
        <StackPanel>
          <Grid>
            <Rectangle Fill="{TemplateBinding Background}"/>
            <ContentPresenter ContentSource="Header"/>
          </Grid>
          <Grid>
            <Rectangle Stroke="{TemplateBinding BorderBrush}"/>
            <ItemsPresenter Margin="2,0,0,0"/>
          </Grid>
        </StackPanel>
      </ControlTemplate>
    </Setter.Value>
  </Setter>
</Style>
<DataTemplate x:Key="RedHeaderTemplate">
  <TextBlock Text="{Binding}" Foreground="Red" 
             FontSize="16" FontWeight="Bold" 
             TextWrapping="Wrap"/>
</DataTemplate>

<DataTemplate x:Key="GreenItemTemplate">
  <TextBlock Text="{Binding}" Foreground="Green" 
             FontSize="14" FontWeight="Bold"></TextBlock>
</DataTemplate>
<!--Crate a HeaderedItemControl with a red header and green items.-->
<HeaderedItemsControl Name="hitemsCtrl"  
                      Background="DarkBlue" 
                      BorderBrush="Black"
                      Header="Header"
                      HeaderTemplate="{StaticResource RedHeaderTemplate}"
                      ItemsSource="{Binding Source={StaticResource Numbers}}"
                      ItemTemplate = "{StaticResource GreenItemTemplate}" />

Комментарии

Чтобы настроить заголовок HeaderedItemsControlобъекта , задайте для этого свойства значение DataTemplate. Дополнительные сведения о шаблонах данных см. в разделе Общие сведения о шаблонах данных.

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

<object HeaderTemplate="{ResourceExtension TemplateResourceKey}"/>  

Использование элемента свойства XAML

Значения XAML

ResourceExtension
Один из следующих вариантов: StaticResource, или DynamicResource. См. раздел Ресурсы XAML.

TemplateResourceKey
Ключ, определяющий запрашиваемый шаблон. Ключ ссылается на существующий ресурс в ResourceDictionary.

Примечание

Синтаксис элемента свойства технически возможен, но не рекомендуется. См. раздел Встроенные стили и шаблоны. Ссылка на привязку с использованием или также возможна, но редко.

Сведения о свойстве зависимостей

Поле идентификатора HeaderTemplateProperty
Для свойств метаданных задано значение true Нет

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

Продукт Версии
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

См. также раздел