ItemsControl.ItemsPanel Свойство

Определение

Пространство имен:

Windows.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 является ItemsPanelTemplate , задающий StackPanel.

Подтипы ItemsControl могут использовать разные элементы ItemsPanelTemplates по умолчанию. Например, элементы ListViewпо умолчанию используют ItemsStackPanel. Использование другого типа может привести к непредвиденному поведению; Например, использование простого StackPanel в качестве элемента ItemsPanel в ListView может снизить поведение экранного диктора во время перетаскивания.

Примеры

Замените панель по умолчанию, используемую в ListView, элементом 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. Использование другой панели в качестве ItemsPanel comboBox не поддерживается и может привести к нежелательному поведению.