ItemsPanelTemplate Klas

Definitie

public ref class ItemsPanelTemplate : System::Windows::FrameworkTemplate

public class ItemsPanelTemplate : System.Windows.FrameworkTemplate

type ItemsPanelTemplate = class
    inherit FrameworkTemplate

Public Class ItemsPanelTemplate
Inherits FrameworkTemplate

Overname

Object

DispatcherObject

FrameworkTemplate

ItemsPanelTemplate

Voorbeelden

Als u een horizontale ListBoxsjabloon wilt maken, kunt u een sjabloon maken waarmee een horizontale StackPanel sjabloon wordt opgegeven en deze als eigenschap ItemsPanel wordt ingesteld. In het volgende voorbeeld ziet u een ListBoxStyle die een horizontaal ListBoxmaakt.

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

In het volgende voorbeeld wordt een ControlTemplate horizontale ListBox weergave gemaakt met afgeronde hoeken. Houd er rekening mee dat in dit voorbeeld, in plaats van de ItemsPanel eigenschap in te stellen zoals in het vorige voorbeeld, de horizontale StackPanel waarde wordt opgegeven in de ControlTemplate. Houd er rekening mee dat de IsItemsHost eigenschap is ingesteld true op het StackPanelitem, waarmee wordt aangegeven dat de gegenereerde items in het deelvenster moeten worden geplaatst. Wanneer u het op deze manier opgeeft, kan de ItemsPanel gebruiker van het besturingselement niet worden vervangen zonder een ControlTemplate. Doe dit daarom alleen als u weet dat u niet wilt dat het paneel wordt vervangen zonder gebruik te maken van een sjabloon.

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

U kunt ook het volgende doen om dezelfde resultaten te bereiken. In dit geval maakt het ItemsPresenter deelvenster voor de indeling van de items op basis van wat is opgegeven door de ItemsPanelTemplate.

<Style TargetType="{x:Type ListBox}">
  <Setter Property="ItemsPanel">
    <Setter.Value>
      <ItemsPanelTemplate>
        <StackPanel Orientation="Horizontal"
                     VerticalAlignment="Center"
                     HorizontalAlignment="Center"/>
      </ItemsPanelTemplate>
    </Setter.Value>
  </Setter>
  <Setter Property="Template">
    <Setter.Value>
      <ControlTemplate TargetType="{x:Type ListBox}">
        <Border CornerRadius="5"
                Background="{TemplateBinding ListBox.Background}">
          <ScrollViewer HorizontalScrollBarVisibility="Auto">
            <ItemsPresenter/>
          </ScrollViewer>
        </Border>
      </ControlTemplate>
    </Setter.Value>
  </Setter>
</Style>

Zie ItemsControl voor een voorbeeld van het gebruik van de verschillende stijl- en sjablooneigenschappen op de pagina.

Opmerkingen

Hiermee ItemsPanelTemplate geeft u het deelvenster op dat wordt gebruikt voor de indeling van items. GroupStyle heeft een Panel eigenschap van het type ItemsPanelTemplate. ItemsControl typen hebben een ItemsPanel eigenschap van het type ItemsPanelTemplate.

Elk ItemsControl type heeft een standaardwaarde ItemsPanelTemplate. Voor de ItemsControl klasse is de standaardwaarde ItemsPanel een ItemsPanelTemplate waarde die een StackPanel. Voor de ListBoxstandaardwaarde wordt de VirtualizingStackPanelstandaardwaarde gebruikt. Voor MenuItem, de standaard gebruikt WrapPanel. Voor StatusBar, de standaard gebruikt DockPanel.