Panel.IsItemsHost 属性

定义

命名空间:

System.Windows.Controls

程序集:

PresentationFramework.dll

获取或设置一个值，该值指示 Panel 这是用户界面 (UI) 项生成的 ItemsControl容器。

public:
 property bool IsItemsHost { bool get(); void set(bool value); };

[System.ComponentModel.Bindable(false)]
public bool IsItemsHost { get; set; }

[<System.ComponentModel.Bindable(false)>]
member this.IsItemsHost : bool with get, set

Public Property IsItemsHost As Boolean

属性值

Boolean

如果此 Panel 实例是项宿主，则为 true；否则为 false。 默认值是 false。

属性

BindableAttribute

示例

以下示例使用 a ControlTemplate 创建水平 ListBox。 水平 StackPanel 在 . 中 ControlTemplate指定。 此属性 IsItemsHost 设置为 true on StackPanel，指示生成的项应放置在面板中。 When you specify it this way, the ItemsPanel cannot be replaced by the user of the control without using a ControlTemplate. 因此，仅当知道不希望在不使用模板的情况下替换面板，才执行此操作。

<Style TargetType="ListBox">
  <Setter Property="Template">
    <Setter.Value>
      <ControlTemplate TargetType="ListBox">
        <Border CornerRadius="5" Background="{TemplateBinding ListBox.Background}">
          <ScrollViewer HorizontalScrollBarVisibility="Auto">
            <StackPanel Orientation="Horizontal"
                       VerticalAlignment="Center"
                       HorizontalAlignment="Center"
                       IsItemsHost="True"/>
          </ScrollViewer>
        </Border>
      </ControlTemplate>
    </Setter.Value>
  </Setter>
</Style>

或者，可以设置 ItemsControl.ItemsPanel 属性。 以下示例设置ItemsPanelStyle其中一个 ListBox。

<Grid.Resources>
  <Style TargetType="Separator">
    <Setter Property="Template">
      <Setter.Value>
        <ControlTemplate TargetType="{x:Type Separator}">
          <Border Width="2" Height="12" Margin="4" Background="Gray"/>
        </ControlTemplate>
      </Setter.Value>
    </Setter>
  </Style>

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

注解

无法将数据绑定到此属性。

依赖项属性信息

标识符字段	IsItemsHostProperty
元数据属性设置为 true	IsNotDataBindable

另请参阅

• ItemsControl