Panel.IsItemsHost Propriété

Référence

Définition

Espace de noms:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit une valeur qui indique qu’il s’agit Panel d’un conteneur pour les éléments d’interface utilisateur générés par un 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

Valeur de propriété

Boolean

true si cette instance de Panel est un hôte d'éléments ; sinon, false. La valeur par défaut est false.

Attributs: BindableAttribute

Exemples

L’exemple suivant utilise un ControlTemplate pour créer un horizontal ListBox. L’horizontal StackPanel est spécifié dans le ControlTemplate. La IsItemsHost propriété est définie true sur le StackPanel, ce qui indique que les éléments générés doivent être placés dans le panneau. Lorsque vous le spécifiez de cette façon, il ItemsPanel ne peut pas être remplacé par l’utilisateur du contrôle sans utiliser de ControlTemplate. Par conséquent, ne faites cela que si vous savez que vous ne souhaitez pas que le panneau soit remplacé sans l’utilisation d’un modèle.

<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>

Vous pouvez également définir la ItemsControl.ItemsPanel propriété. L’exemple suivant définit l’élément ItemsPanel dans un Style objet 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>

Remarques

Vous ne pouvez pas lier de données à cette propriété.

Informations sur les propriétés de dépendance


Champ d’identificateur	IsItemsHostProperty
Propriétés de métadonnées définies sur `true`	IsNotDataBindable

S’applique à

Voir aussi

ItemsControl