ItemsControl.ItemsPanel Propiedad

Definición

Espacio de nombres:

Windows.UI.Xaml.Controls

Obtiene o establece la plantilla que define el panel que controla el diseño de elementos.

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

ItemsPanelTemplate

ItemsPanelTemplate que define el panel que se va a usar para el diseño de los elementos. El valor predeterminado de ItemsControl es itemsPanelTemplate que especifica un StackPanel.

Los subtipos de ItemsControl pueden usar diferentes itemsPanelTemplates predeterminados. Por ejemplo, ListViews de forma predeterminada usa un ItemsStackPanel. El uso de un tipo diferente puede provocar un comportamiento inesperado; por ejemplo, el uso de un StackPanel sin formato como itemsPanel de ListView puede retroceder el comportamiento del narrador durante la arrastrar y colocar.

Ejemplos

Reemplace el panel predeterminado usado en un ListView por un ItemsStackPanel que tenga su Orientación cambiada a Horizontal.

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

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

Comentarios

Nota:

ComboBox usa un CarouselPanel como su ItemsPanel. No se admite el uso de un panel diferente como ItemsPanel de ComboBox y podría dar lugar a un comportamiento no deseado.