Panel.IsItemsHost Eigenschaft

Definition

Ruft einen Wert ab, der angibt, dass dieser Panel ein Container für Benutzeroberfläche (User Interface, UI)user interface (UI)-Elemente ist, die von einem ItemsControl generiert werden, oder legt diesen Wert fest.Gets or sets a value that indicates that this Panel is a container for Benutzeroberfläche (User Interface, UI)user interface (UI) items that are generated by an ItemsControl.

public:
 property bool IsItemsHost { bool get(); void set(bool value); };
[System.ComponentModel.Bindable(false)]
public bool IsItemsHost { get; set; }
member this.IsItemsHost : bool with get, set
Public Property IsItemsHost As Boolean

Eigenschaftswert

true, wenn diese Instanz von Panel ein Elementhost ist, andernfalls false.true if this instance of Panel is an items host; otherwise, false. Der Standardwert ist falsesein.The default value is false.

Attribute

Beispiele

Im folgenden Beispiel wird ein ControlTemplate -verwendet, um ListBoxeinen horizontalen zu erstellen.The following example uses a ControlTemplate to create a horizontal ListBox. Die horizontale StackPanel wird in der ControlTemplateangegeben.The horizontal StackPanel is specified within the ControlTemplate. Die IsItemsHost -Eigenschaft ist true auf festgelegt StackPanel, was angibt, dass die generierten Elemente in den Bereich eingefügt werden sollen.The IsItemsHost property is set to true on the StackPanel, which indicates that the generated items should be placed in the panel. Wenn Sie diese auf diese Weise angeben, ItemsPanel kann der nicht durch den Benutzer des-Steuer Elements ersetzt werden ControlTemplate, ohne zu verwenden.When you specify it this way, the ItemsPanel cannot be replaced by the user of the control without using a ControlTemplate. Daher sollten Sie dies nur tun, wenn Sie wissen, dass der Bereich nicht ohne eine Vorlage ersetzt werden soll.Therefore, do this only if you know that you do not want the panel to be replaced without the use of a template.

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

Alternativ können Sie die ItemsControl.ItemsPanel -Eigenschaft festlegen.Alternatively, you can set the ItemsControl.ItemsPanel property. Im folgenden Beispiel wird der ItemsPanel in einem Style -Wert ListBoxvon festgelegt.The following example sets the ItemsPanel in a Style of a 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>

Hinweise

Es ist nicht möglich, Daten an diese Eigenschaft zu binden.You cannot bind data to this property.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field IsItemsHostProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true IsNotDataBindable

Gilt für:

Siehe auch