ItemsControl.ItemsPanel Propriété

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Obtient ou définit le modèle qui définit le panneau qui contrôle la disposition d'éléments.

public:
 property ItemsPanelTemplate ^ ItemsPanel { ItemsPanelTemplate ^ get(); void set(ItemsPanelTemplate ^ value); };

ItemsPanelTemplate ItemsPanel();

void ItemsPanel(ItemsPanelTemplate value);

public ItemsPanelTemplate ItemsPanel { get; set; }

var itemsPanelTemplate = itemsControl.itemsPanel;
itemsControl.itemsPanel = itemsPanelTemplate;

Public Property ItemsPanel As ItemsPanelTemplate

<itemsControl>
  <itemsControl.ItemsPanel>
    singlePanelTemplate
  </itemsControl.ItemsPanel>
</itemsControl>
- or -
<itemsControl ItemsPanel="resourceReferenceToPanelTemplate"/>

Valeur de propriété

ItemsPanelTemplate

ÉlémentPanelTemplate qui définit le panneau à utiliser pour la disposition des éléments. La valeur par défaut de ItemsControl est un ItemsPanelTemplate qui spécifie un StackPanel.

Les sous-types d’ItemsControl peuvent utiliser différents ItemsPanelTemplates par défaut. Par exemple, ListViews utilise par défaut un ItemsStackPanel. L’utilisation d’un autre type peut entraîner un comportement inattendu ; par exemple, l’utilisation d’un StackPanel simple comme élément ItemsPanel de ListView peut régresser le comportement du Narrateur pendant le glisser-déplacer.

Exemples

Remplacez le panneau par défaut utilisé dans un Contrôle ListView par un ItemsStackPanel dont l’orientation est remplacée par Horizontale.

<ListView>
    <x:String>Hello</x:String>
    <x:String>World</x:String>

    <ItemsControl.ItemsPanel>
        <ItemsPanelTemplate>
            <ItemsStackPanel Orientation="Horizontal" />
        </ItemsPanelTemplate>
    </ItemsControl.ItemsPanel>
</ListView>

Remarques

Notes

ComboBox utilise un CarouselPanel comme élément. L’utilisation d’un autre panneau comme ÉlémentPanel de ComboBox n’est pas prise en charge et peut entraîner un comportement indésirable.