Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

ItemsControl.ItemsPanel-Eigenschaft

 

Veröffentlicht: Oktober 2016

Ruft die Vorlage ab (bzw. legt diese fest), mit der der Bereich definiert wird, der das Layout der Elemente steuert.

Namespace:   System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)

[BindableAttribute(false)]
public ItemsPanelTemplate ItemsPanel { get; set; }

Eigenschaftswert

Type: System.Windows.Controls.ItemsPanelTemplate

Eine ItemsPanelTemplate, die den Bereich für das Layout der Elemente definiert. Der Standardwert für das ItemsControl ist eine ItemsPanelTemplate, die ein StackPanel angibt.

Für die ListBox, der Standardwert ItemsPanelTemplate Gibt die VirtualizingStackPanel. Für MenuItem, verwendet den WrapPanel. Für StatusBar, verwendet den DockPanel.

Beeinflusst das Layout der Elemente in einer ItemsControl, verwenden Sie diese Eigenschaft an ein ItemsPanelTemplate.

Die ItemsControl bietet eine umfassende Flexibilität bei der visuellen Anpassung und stellt eine Vielzahl von Formaten und Vorlagen bereit. Verwenden Sie die ItemContainerStyle Eigenschaft oder die ItemContainerStyleSelector Eigenschaft, um ein Format festzulegen, die die Darstellung der Elemente angibt, die Datenelemente enthalten. Z. B. für ListBox, sind die generierten Container ListBoxItem steuert; für ComboBox, sie sind ComboBoxItem Steuerelemente. Wenn Sie die Gruppierung für das Steuerelement verwenden, können Sie mithilfe der GroupStyle oder GroupStyleSelector Eigenschaft. Um die Visualisierung der Datenobjekte anzugeben, verwenden Sie die ItemTemplate oder die ItemTemplateSelector Eigenschaft. Weitere Informationen finden Sie unter Übersicht über Datenvorlagen.

Feld-ID

ItemsPanelProperty

Festgelegte Metadateneigenschaften true

Keine

Zum Erstellen einer horizontalen ListBox, können Sie eine Vorlage, die eine horizontale gibt erstellen StackPanel und legen Sie es als die ItemsPanel Eigenschaft. Das folgende Beispiel zeigt eine ListBox Style erstellt eine horizontale ListBox

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

Im folgenden Beispiel wird eine ControlTemplate zum Erstellen einer horizontalen ListBox mit abgerundeten Ecken. In diesem Beispiel, anstatt durch die Einstellung der ItemsPanel Eigenschaft wie im vorherigen Beispiel, die horizontale StackPanel angegeben ist, innerhalb der ControlTemplate. Die IsItemsHost -Eigenschaft wird festgelegt, um true auf die StackPanel, bedeutet, dass die generierten Elemente in den Bereich eingefügt werden sollen. Wenn Sie auf diese Weise verwenden der ItemsPanel kann nicht vom Benutzer des Steuerelements ersetzt werden, ohne eine ControlTemplate. Aus diesem Grund nur dazu, wenn Sie wissen, dass Sie nicht den Bereich ohne Verwendung einer Vorlage ersetzt werden soll.

Alternativ können Sie Folgendes ein, um die gleichen Ergebnisse erzielen tun. In diesem Fall die ItemsPresenter erstellt den Bereich für das Layout der Elemente anhand der Angaben von angegeben, wird die ItemsPanelTemplate.

.NET Framework
Verfügbar seit 3.0
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Zurück zum Anfang
Anzeigen: