ItemsControl.ItemsPanel Propriedade

Definição

Namespace:

Windows.UI.Xaml.Controls

Obtém ou define o modelo que define o painel que controla o layout dos itens.

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

Valor da propriedade

ItemsPanelTemplate

Um ItemsPanelTemplate que define o painel a ser usado para o layout dos itens. O valor padrão para o ItemsControl é um ItemsPanelTemplate que especifica um StackPanel.

Subtipos de ItemsControl podem usar itemsPanelTemplates padrão diferentes. Por exemplo, ListViews por padrão usam um ItemsStackPanel. O uso de um tipo diferente pode causar um comportamento inesperado; por exemplo, usar um StackPanel simples como ItemsPanel do ListView pode regredir o comportamento do Narrador durante arrastar e soltar.

Exemplos

Substitua o painel padrão usado em um ListView por um ItemsStackPanel que tenha sua Orientação alterada para Horizontal.

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

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

Comentários

Observação

O ComboBox usa um CarouselPanel como seu ItemsPanel. Não há suporte para o uso de um painel diferente, pois o ItemsPanel do ComboBox não tem suporte e pode resultar em um comportamento indesejado.