Panel.IsItemsHost Panel.IsItemsHost Panel.IsItemsHost Panel.IsItemsHost Property

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.

Beispiele

Im folgenden Beispiel wird eine ControlTemplate zum Erstellen einer horizontalen ListBox.The following example uses a ControlTemplate to create a horizontal ListBox. Die horizontale StackPanel angegeben ist, in der ControlTemplate.The horizontal StackPanel is specified within the ControlTemplate. Die IsItemsHost -Eigenschaftensatz auf true auf die StackPanel, was bedeutet, dass die generierten Elemente in den Bereich eingefügt werden soll.The IsItemsHost property is set to true on the StackPanel, which indicates that the generated items should be placed in the panel. Wenn Sie auf diese Weise angeben der ItemsPanel kann nicht vom Benutzer des Steuerelements ersetzt werden, ohne eine ControlTemplate.When you specify it this way, the ItemsPanel cannot be replaced by the user of the control without using a ControlTemplate. Aus diesem Grund dies nur tun, wenn Sie wissen, dass Sie nicht möchten, dass den Bereich ohne Verwendung einer Vorlage ersetzt werden.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>

Sie können alternativ Festlegen der ItemsControl.ItemsPanel Eigenschaft.Alternatively, you can set the ItemsControl.ItemsPanel property. Im folgenden Beispiel wird die ItemsPanel in einer Style von einem ListBox.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

Sie können keine Daten für diese Eigenschaft binden.You cannot bind data to this property.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

Feld "ID"Identifier field IsItemsHostProperty
Legen Sie auf der Metadaten-Eigenschaften trueMetadata properties set to true IsNotDataBindable

Gilt für:

Siehe auch