groupstyle_panel.md

-api-id	-api-type
P:Windows.UI.Xaml.Controls.GroupStyle.Panel	winrt property

Windows.UI.Xaml.Controls.GroupStyle.Panel

-description

Gets or sets a template that creates the panel used to lay out the items.

-xaml-syntax

<GroupStyle Panel="itemsPanelTemplateReference" />
- or -
<GroupStyle>
  <GroupStyle.Panel>
    singleItemsPanelTemplate
  </GroupStyle.Panel>
</GroupStyle>  

-xaml-values

itemsPanelTemplateReference

itemsPanelTemplateReferenceA reference to an existing ItemsPanelTemplate. Typically this is a keyed resource, which you reference through {StaticResource} markup extension.

singleItemsPanelTemplate

singleItemsPanelTemplateA single ItemsPanelTemplate object element defined inline, which declares the items template for the view.

## -property-value An [ItemsPanelTemplate](itemspaneltemplate.md) object that creates the panel used to layout the items.

-remarks

An ItemsPanelTemplate object element should contain exactly one FrameworkElement-derived class that serves as the root element for items. In most cases this is a Panel-derived class. The expanded template serves as the parent for the realized items and there generally is more than one item. Therefore the XAML content property of the intended root element of an ItemsPanelTemplate should support a collection, as Panel.Children does.

Important

The root element of the template declared for the ItemsPanelTemplate in the GroupStyle.Panel property cannot be a virtualizing panel. Virtualizing panels are defined as any type that derives from VirtualizingPanel, for example the VirtualizingStackPanel class.

-examples

-see-also