ItemsControl.ItemsPanel Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Controls

Ottiene o imposta il modello che definisce il pannello che controlla il layout di elementi.

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

Valore della proprietà

ItemsPanelTemplate

ItemsPanelTemplate che definisce il pannello da usare per il layout degli elementi. Il valore predefinito per ItemsControl è itemsPanelTemplate che specifica un oggetto StackPanel.

I sottotipi di ItemsControl possono usare elementi predefiniti diversiPanelTemplate. Ad esempio, ListViews per impostazione predefinita usa ItemsStackPanel. L'uso di un tipo diverso può causare un comportamento imprevisto; Ad esempio, l'uso di un oggetto StackPanel normale come ItemsPanel di ListView può regredire il comportamento dell'Assistente vocale durante il trascinamento della selezione.

Esempio

Sostituire il pannello predefinito usato in un controllo ListView con itemsStackPanel con orientamento impostato su Orizzontale.

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

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

Commenti

Nota

ComboBox usa un controllo CarouselPanel come ItemsPanel. L'uso di un pannello diverso come ItemsPanel di ComboBox non è supportato e potrebbe comportare un comportamento indesiderato.