ItemsPanelTemplate Classe

Definição

public ref class ItemsPanelTemplate : System::Windows::FrameworkTemplate

public class ItemsPanelTemplate : System.Windows.FrameworkTemplate

type ItemsPanelTemplate = class
    inherit FrameworkTemplate

Public Class ItemsPanelTemplate
Inherits FrameworkTemplate

Herança

Object

DispatcherObject

FrameworkTemplate

ItemsPanelTemplate

Exemplos

Para criar uma horizontal ListBox, pode criar um modelo que especifique uma horizontal StackPanel e defini-la como a ItemsPanel propriedade. O exemplo seguinte mostra um ListBoxStyle que cria um horizontal ListBox.

<Style TargetType="ListBox">
  <Setter Property="ItemsPanel">
    <Setter.Value>
      <ItemsPanelTemplate>
        <StackPanel Orientation="Horizontal"
                    VerticalAlignment="Center"
                    HorizontalAlignment="Center"/>
      </ItemsPanelTemplate>
    </Setter.Value>
  </Setter>
</Style>

O exemplo seguinte usa a ControlTemplate para criar uma horizontal ListBox com cantos arredondados. Note-se que neste exemplo, em vez de definir a ItemsPanel propriedade como no exemplo anterior, o horizontal StackPanel é especificado dentro do ControlTemplate. Note que a IsItemsHost propriedade está definida para true em , StackPanelindicando que os itens gerados devem ir no painel. Quando se especifica desta forma, o ItemsPanel não pode ser substituído pelo utilizador do controlo sem usar um ControlTemplate. Portanto, só faça isto se souber que não gostaria que o quadro fosse substituído sem o uso de um modelo.

<Style TargetType="ListBox">
  <Setter Property="Template">
    <Setter.Value>
      <ControlTemplate TargetType="ListBox">
        <Border CornerRadius="5" Background="{TemplateBinding ListBox.Background}">
          <ScrollViewer HorizontalScrollBarVisibility="Auto">
            <StackPanel Orientation="Horizontal"
                       VerticalAlignment="Center"
                       HorizontalAlignment="Center"
                       IsItemsHost="True"/>
          </ScrollViewer>
        </Border>
      </ControlTemplate>
    </Setter.Value>
  </Setter>
</Style>

Em alternativa, pode fazer o seguinte para obter os mesmos resultados. Neste caso, o ItemsPresenter cria o painel para a disposição dos itens com base no que é especificado pelo ItemsPanelTemplate.

<Style TargetType="{x:Type ListBox}">
  <Setter Property="ItemsPanel">
    <Setter.Value>
      <ItemsPanelTemplate>
        <StackPanel Orientation="Horizontal"
                     VerticalAlignment="Center"
                     HorizontalAlignment="Center"/>
      </ItemsPanelTemplate>
    </Setter.Value>
  </Setter>
  <Setter Property="Template">
    <Setter.Value>
      <ControlTemplate TargetType="{x:Type ListBox}">
        <Border CornerRadius="5"
                Background="{TemplateBinding ListBox.Background}">
          <ScrollViewer HorizontalScrollBarVisibility="Auto">
            <ItemsPresenter/>
          </ScrollViewer>
        </Border>
      </ControlTemplate>
    </Setter.Value>
  </Setter>
</Style>

Para um exemplo de como usar as diferentes propriedades de estilização e de templates no ItemsControl, veja Visão Geral de Templação de Dados.

Observações

Especifica ItemsPanelTemplate o painel utilizado para a disposição dos itens. GroupStyle tem uma Panel propriedade que é do tipo ItemsPanelTemplate. ItemsControl Os tipos têm uma ItemsPanel propriedade que é do tipo ItemsPanelTemplate.

Cada ItemsControl tipo tem um padrão ItemsPanelTemplate. Para a ItemsControl classe, o valor padrão ItemsPanel é um ItemsPanelTemplate que especifica um StackPanel. Para o ListBox, o padrão usa o VirtualizingStackPanel. Para MenuItem, o padrão usa WrapPanel. Para StatusBar, o padrão usa DockPanel.