Panel.IsItemsHost Свойство

Определение

Пространство имен:

System.Windows.Controls

Сборка:

PresentationFramework.dll

Возвращает или задает значение, указывающее, что это Panel контейнер для элементов пользовательского интерфейса, создаваемых 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

Значение true, если данный экземпляр Panel размещает элементы; в противном случае — значение false. Значение по умолчанию — false.

Атрибуты

BindableAttribute

Примеры

В следующем примере используется ControlTemplate для создания горизонтального ListBox. Горизонтальная StackPanel указана в элементе ControlTemplate. Для IsItemsHost свойства задано true StackPanelзначение , указывающее, что созданные элементы должны быть помещены на панель. Если указать его таким образом, ItemsPanel пользователь элемента управления не может заменить его без использования 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 свойство. В следующем примере задается ItemsPanel значение in a Style 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
Metadata properties set to true	IsNotDataBindable

См. также раздел

• ItemsControl