ItemsPanelTemplate Класс

Определение

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

public class ItemsPanelTemplate : System.Windows.FrameworkTemplate

type ItemsPanelTemplate = class
    inherit FrameworkTemplate

Public Class ItemsPanelTemplate
Inherits FrameworkTemplate

Наследование

Object

DispatcherObject

FrameworkTemplate

ItemsPanelTemplate

Примеры

Чтобы создать горизонтальное, можно создать шаблон, указывающий горизонтальную ListBoxStackPanel и задающую его в качестве ItemsPanel свойства. В следующем примере показаноListBoxStyle, как создать горизонтальную.ListBox

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

В следующем примере используется ControlTemplate для создания горизонтального ListBox с округлениями углов. Обратите внимание, что в этом примере вместо задания ItemsPanel свойства, как в предыдущем примере, горизонтальная StackPanel указана внутри ControlTemplate. Обратите внимание, что для свойства задано trueStackPanelзначение , указывающее, IsItemsHost что созданные элементы должны находиться на панели. При указании этого способа ItemsPanel невозможно заменить пользователя элемента управления без использования элемента ControlTemplateуправления. Таким образом, только если вы знаете, что панель не будет заменена без использования шаблона.

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

Кроме того, можно выполнить следующие действия, чтобы добиться того же результата. В этом случае ItemsPresenter создается панель для макета элементов на основе того, что указано в объекте 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>

Пример использования различных свойств стилей и шаблонов в разделе ItemsControl"Общие сведения о шаблоне данных".

Комментарии

Указывает ItemsPanelTemplate панель, используемую для макета элементов. GroupStyle Panel имеет свойство, которое имеет типItemsPanelTemplate. ItemsControl типы имеют ItemsPanel свойство, которое имеет тип ItemsPanelTemplate.

Каждый ItemsControl тип имеет значение по умолчанию ItemsPanelTemplate. ItemsControl Для класса значение по умолчанию ItemsPanel — это ItemsPanelTemplate значение, указывающее StackPanel. Для параметра ListBoxпо умолчанию используется VirtualizingStackPanel. Для MenuItemпараметра по умолчанию используется WrapPanel. Для StatusBarпараметра по умолчанию используется DockPanel.