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의 기본값은 StackPanel을 지정하는 ItemsPanelTemplate입니다.

ItemsControl의 하위 형식은 다른 기본 ItemsPanelTemplates를 사용할 수 있습니다. 예를 들어 ListView는 기본적으로 ItemsStackPanel을 사용합니다. 다른 형식을 사용하면 예기치 않은 동작이 발생할 수 있습니다. 예를 들어 ListView의 ItemsPanel로 일반 StackPanel을 사용하면 끌어서 놓는 동안 내레이터 동작을 회귀할 수 있습니다.

예제

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로 사용합니다. 다른 패널을 ComboBox 의 ItemsPanel로 사용하는 것은 지원되지 않으며 원치 않는 동작이 발생할 수 있습니다.