要查看英语原文,请勾选“英语”复选框。也可将鼠标指针移到文本上,在弹出窗口中显示英语原文。
翻译
英语

ItemsControl.ItemsPanel 属性

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

命名空间:  System.Windows.Controls
程序集:  System.Windows(在 System.Windows.dll 中)

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

Dependency property identifier field: ItemsPanelProperty

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

下面的示例创建一个水平显示各个项的 ListBox 该示例将 ItemsPanel 设置为 ItemsPanelTemplate,后者具有一个 Orientation 属性设置为 HorizontalStackPanel


<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

水平放置项的列表框。

Silverlight

受以下版本支持:5、4、3

Silverlight for Windows Phone

受以下版本支持:Windows Phone OS 7.1、Windows Phone OS 7.0

有关 Silverlight 支持的操作系统和浏览器的列表,请参见 支持的操作系统和浏览器

社区附加资源

添加
显示: