ItemsPanelTemplate Classe

Définition

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

public class ItemsPanelTemplate : System.Windows.FrameworkTemplate

type ItemsPanelTemplate = class
    inherit FrameworkTemplate

Public Class ItemsPanelTemplate
Inherits FrameworkTemplate

Héritage

Object

DispatcherObject

FrameworkTemplate

ItemsPanelTemplate

Exemples

Pour créer un ListBoxhorizontal, vous pouvez créer un modèle qui spécifie un StackPanel horizontal et le définir comme propriété ItemsPanel. L’exemple suivant montre un ListBoxStyle qui crée une ListBoxhorizontale.

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

L’exemple suivant utilise un ControlTemplate pour créer un ListBox horizontal qui a des angles arrondis. Notez que dans cet exemple, au lieu de définir la propriété ItemsPanel comme dans l’exemple précédent, la StackPanel horizontale est spécifiée dans le ControlTemplate. Notez que la propriété IsItemsHost est définie sur true sur le StackPanel, indiquant que les éléments générés doivent se trouver dans le panneau. Lorsque vous le spécifiez de cette façon, la ItemsPanel ne peut pas être remplacée par l’utilisateur du contrôle sans utiliser de ControlTemplate. Par conséquent, effectuez cette opération uniquement si vous savez que vous ne souhaitez pas que le panneau soit remplacé sans l’utilisation d’un modèle.

<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>

Vous pouvez également effectuer les opérations suivantes pour obtenir les mêmes résultats. Dans ce cas, le ItemsPresenter crée le panneau pour la disposition des éléments en fonction de ce qui est spécifié par le 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>

Pour obtenir un exemple d’utilisation des différentes propriétés de style et de création de modèles sur le ItemsControl, consultez Vue d’ensemble de la création de modèles de données.

Remarques

Le ItemsPanelTemplate spécifie le panneau utilisé pour la disposition des éléments. GroupStyle a une propriété Panel de type ItemsPanelTemplate. ItemsControl types ont une propriété ItemsPanel de type ItemsPanelTemplate.

Chaque type ItemsControl a une ItemsPanelTemplatepar défaut. Pour la classe ItemsControl, la valeur ItemsPanel par défaut est une ItemsPanelTemplate qui spécifie un StackPanel. Pour l'ListBox, la valeur par défaut utilise la VirtualizingStackPanel. Pour MenuItem, la valeur par défaut utilise WrapPanel. Pour StatusBar, la valeur par défaut utilise DockPanel.

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à