Compartilhar via


GridViewColumn.HeaderContainerStyle Propriedade

Definição

Obtém ou define o estilo a ser usado para o cabeçalho do 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

Valor da propriedade

Style

O Style que define as propriedades de exibição para o cabeçalho de coluna. O padrão é null.

Exemplos

O exemplo a seguir mostra como definir um HeaderContainerStyle que especifica propriedades de exibição para um cabeçalho de coluna.

<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}"/>

O exemplo a seguir mostra como definir um HeaderContainerStyle que define as propriedades de exibição usando um 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>

Comentários

A HeaderContainerStyle propriedade e a HeaderTemplate propriedade podem definir juntos valores de propriedade e a árvore visual para o conteúdo do cabeçalho da coluna. A HeaderContainerStyle propriedade também pode especificar a árvore visual definindo um ControlTemplate.

As propriedades que definem o conteúdo, o layout e o estilo de um cabeçalho de coluna são encontradas em muitas classes relacionadas e algumas dessas propriedades têm funcionalidade semelhante ou a mesma. Para obter mais informações, consulte Visão geral de modelos e estilos de cabeçalho de coluna GridView.

Quando você define um estilo, algumas restrições se aplicam. Para obter mais informações, consulte o Estilo e a Modelagem.

Uso do Atributo XAML

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

Uso do elemento propriedade XAML

Valores XAML

ResourceExtension
Um dos seguintes: StaticResource, ou DynamicResource. Consulte recursos XAML.

StyleResourceKey
A chave que identifica o estilo que está sendo solicitado. A chave refere-se a um recurso existente em um ResourceDictionary.

Observação

A sintaxe do elemento property é tecnicamente possível, mas não é recomendada. Consulte estilos e modelos embutidos. Uma referência de associação usando ou também é possível, mas incomum.

Informações da propriedade de dependência

Campo identificador HeaderContainerStyleProperty
Propriedades de metadados definidas como true Nenhum

Aplica-se a

Confira também