ItemsControl.ItemsPanel 속성

2013-12-13

항목의 레이아웃을 제어하는 패널을 정의하는 템플릿을 가져오거나 설정합니다.

Namespace:  System.Windows.Controls
어셈블리:  System.Windows(System.Windows.dll)
XMLNS for XAML: xmlns에 매핑되지 않습니다.

‘선언
Public Property ItemsPanel As ItemsPanelTemplate
<itemsControl>
  <itemsControl.ItemsPanel>
    singlePanelTemplate
  </itemsControl.ItemsPanel>
</itemsControl>
<itemsControl ItemsPanel="resourceReferenceToPanelTemplate"/>

XAML 값

singlePanelTemplate

단일 ItemsPanelTemplate 개체 요소입니다. 이 ItemsPanelTemplate에는 일반적으로 패널 레이아웃을 정의하는 여러 개의 자식 요소가 있습니다.

resourceReferenceToPanelTemplate

리소스 컬렉션에서 기존 ItemsPanelTemplate에 대한 리소스 참조입니다. 리소스 참조는 키를 통해 원하는 ItemsPanelTemplate을 지정해야 합니다.

속성 값

형식: System.Windows.Controls.ItemsPanelTemplate
항목 레이아웃에 사용할 패널을 정의하는 ItemsPanelTemplate입니다. ItemsControl의 기본값은 StackPanel을 지정하는 ItemsPanelTemplate입니다.

종속성 속성 식별자 필드: ItemsPanelProperty

ItemsControl의 항목 레이아웃에 영향을 주려면 이 속성을 사용하여 ItemsPanelTemplate을 지정합니다.

다음 예제에서는 항목이 가로로 표시되는 ListBox를 만듭니다. 이 예제에서는 ItemsPanelStackPanelOrientation 속성이 Horizontal로 설정된 ItemsPanelTemplate으로 설정합니다. 이 예제의 경우 srcxmlns:src="clr-namespace:ItemsControlSnippets"로 정의됩니다.


<Grid>
  <Grid.Resources>
    <Style x:Key="horizontalListBoxStyle" TargetType="ListBox">
      <Setter Property="ItemsPanel">
        <Setter.Value>
          <ItemsPanelTemplate>
            <StackPanel Orientation="Horizontal"
              VerticalAlignment="Center"
              HorizontalAlignment="Center"/>
          </ItemsPanelTemplate>
        </Setter.Value>
      </Setter>
    </Style>

    <src:Items x:Key="items"/>
  </Grid.Resources>

  <ListBox ItemsSource="{StaticResource items}" 
           Style="{StaticResource horizontalListBoxStyle}"/>

</Grid>


다음 예제에서는 ListBox가 바인딩되는 문자열의 컬렉션을 보여 줍니다.


Public Class Items
    Inherits System.Collections.ObjectModel.ObservableCollection(Of String)

    Public Sub New()
        Add("Item 1")
        Add("Item 2")
        Add("Item 3")
        Add("Item 4")
        Add("Item 5")
    End Sub
End Class


앞의 예제에서는 다음 그림과 유사한 출력을 생성합니다.

항목이 가로로 정렬된 ListBox

A ListBox that positions items horizontally.

Windows Phone OS

지원되는 버전: 8.0, 7.1, 7.0

Windows Phone

표시:
© 2015 Microsoft