ItemsControl.ItemsPanel Property

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Gets or sets the template that defines the panel that controls the layout of items.

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

Property Value

ItemsPanelTemplate

An ItemsPanelTemplate that defines the panel to use for the layout of the items. The default value for the ItemsControl is an ItemsPanelTemplate that specifies a StackPanel.

Examples

Replace the default panel used in a ListView with an ItemsStackPanel that has its Orientation changed to Horizontal.

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

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

Remarks

Note

ComboBox uses a CarouselPanel as its ItemsPanel. Using a different panel as the ItemsPanel of ComboBox is not supported and might result in undesired behavior.