ItemsControl.ItemsPanel Eigenschaft

Definition

Namespace:

Windows.UI.Xaml.Controls

Ruft die Vorlage ab (bzw. legt diese fest), mit der der Bereich definiert wird, der das Layout der Elemente steuert.

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

Eigenschaftswert

ItemsPanelTemplate

Ein ItemsPanelTemplate-Objekt , das den Bereich definiert, der für das Layout der Elemente verwendet werden soll. Der Standardwert für das ItemsControl ist eine ItemsPanelTemplate , die ein StackPanel angibt.

Untertypen von ItemsControl können verschiedene StandardelementePanelTemplates verwenden. ListViewsverwenden beispielsweise standardmäßig ein ItemsStackPanel. Die Verwendung eines anderen Typs kann zu unerwartetem Verhalten führen. Wenn Sie beispielsweise ein einfaches StackPanel als ItemsPanel der ListView verwenden, kann das Sprachausgabeverhalten während des Ziehens und Ablegens zurücktreten.

Beispiele

Ersetzen Sie den in einer ListView verwendeten Standardbereich durch ein ItemsStackPanel , dessen Ausrichtung in Horizontal geändert wurde.

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

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

Hinweise

Hinweis

ComboBox verwendet ein CarouselPanel als ItemsPanel. Die Verwendung eines anderen Bereichs als ItemsPanel von ComboBox wird nicht unterstützt und kann zu unerwünschtem Verhalten führen.