此页面有用吗?
您对此内容的反馈非常重要。 请告诉我们您的想法。
更多反馈?
1500 个剩余字符
MSDN Library
信息
您所需的主题如下所示。但此主题未包含在此库中。

ItemsControl.ItemsPanel 属性

2013/12/13

获取或设置模板,它定义了控制项的布局的面板。

Namespace:  System.Windows.Controls
程序集:  System.Windows(位于 System.Windows.dll 中)
XMLNS for XAML: 未映射到 xmlns。

public ItemsPanelTemplate ItemsPanel { get; set; }
<itemsControl>
  <itemsControl.ItemsPanel>
    singlePanelTemplate
  </itemsControl.ItemsPanel>
</itemsControl>
<itemsControl ItemsPanel="resourceReferenceToPanelTemplate"/>

XAML 值

singlePanelTemplate

一个 ItemsPanelTemplate 对象元素。ItemsPanelTemplate 通常具有多个子元素,它们定义面板布局。

resourceReferenceToPanelTemplate

从资源集合对现有 ItemsPanelTemplate 进行的资源引用。资源引用必须通过键来指定所需的 ItemsPanelTemplate

属性值

类型: System.Windows.Controls.ItemsPanelTemplate
一个 ItemsPanelTemplate,它定义了用于项的布局的面板。ItemsControl 的默认值是一个指定 StackPanelItemsPanelTemplate

依赖项属性标识符字段: ItemsPanelProperty

若要影响 ItemsControl 中项的布局,可以使用此属性来指定一个 ItemsPanelTemplate

下面的示例创建一个水平显示各个项的 ListBox。该示例将 ItemsPanel 设置为 ItemsPanelTemplate,后者具有一个 Orientation 属性设置为 HorizontalStackPanel。对于此示例,src 被定义为 xmlns: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 : 
    System.Collections.ObjectModel.ObservableCollection<string>
{
    public Items()
    {
        Add("Item 1");
        Add("Item 2");
        Add("Item 3");
        Add("Item 4");
        Add("Item 5");
    }
}


前面的示例生成类似于下图的输出。

具有水平排列的项的 ListBox

A ListBox that positions items horizontally.

Windows Phone OS

受以下版本支持: 8.0, 7.1, 7.0

Windows Phone

显示:
© 2015 Microsoft