ItemsPanelTemplate Klass

Definition

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

public class ItemsPanelTemplate : System.Windows.FrameworkTemplate

type ItemsPanelTemplate = class
    inherit FrameworkTemplate

Public Class ItemsPanelTemplate
Inherits FrameworkTemplate

Arv

Object

DispatcherObject

FrameworkTemplate

ItemsPanelTemplate

Exempel

Om du vill skapa en vågrät ListBoxkan du skapa en mall som anger en vågrät StackPanel och ange den som ItemsPanel egenskap. I följande exempel visas ett ListBoxStyle som skapar en vågrät ListBox.

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

I följande exempel används en ControlTemplate för att skapa en vågrät ListBox som har rundade hörn. Observera att i det här exemplet, i stället för att ange ItemsPanel egenskapen som i föregående exempel, anges den vågräta i StackPanelControlTemplate. Observera att egenskapen IsItemsHost är inställd true på på StackPanel, som anger att de genererade objekten ska gå till panelen. När du anger det på det här sättet kan ItemsPanel inte ersättas av användaren av kontrollen utan att använda en ControlTemplate. Därför gör du bara detta om du vet att du inte vill att panelen ska ersättas utan att använda en mall.

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

Du kan också göra följande för att uppnå samma resultat. I det här fallet ItemsPresenter skapar panelen för layouten för objekten baserat på vad som anges av 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>

Ett exempel på hur du använder de olika format- och mallegenskaperna i finns i ItemsControlÖversikt över dataöversikt.

Kommentarer

ItemsPanelTemplate Anger den panel som används för layouten av objekt. GroupStyle har en Panel egenskap av typen ItemsPanelTemplate. ItemsControl typer har en ItemsPanel egenskap som är av typen ItemsPanelTemplate.

Varje ItemsControl typ har standardvärdet ItemsPanelTemplate. ItemsControl För klassen är standardvärdet ItemsPanel ett ItemsPanelTemplate som anger en StackPanel. ListBoxFör använder standardinställningen VirtualizingStackPanel. För MenuItemanvänder WrapPanelstandardinställningen . För StatusBaranvänder DockPanelstandardinställningen .