ItemsControl.ItemsPanel 属性

定义

命名空间:

Microsoft.UI.Xaml.Controls

获取或设置模板，该模板定义对项的布局进行控制的面板。

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

属性值

ItemsPanelTemplate

一个 ItemsPanelTemplate，用于定义要用于项布局的面板。 ItemsControl 的默认值是指定 StackPanel 的 ItemsPanelTemplate。

示例

将 ListView 中使用的默认面板替换为其方向更改为 Horizontal 的 ItemsStackPanel 。

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

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

注解

注意

ComboBox 使用 CarouselPanel 作为其 ItemsPanel。 不支持将其他面板用作 ComboBox 的 ItemsPanel，这可能会导致意外行为。