ItemsPanelTemplate Classe

Definição

Especifica o painel que o ItemsPresenter cria para o layout dos itens de um ItemsControl.Specifies the panel that the ItemsPresenter creates for the layout of the items of an ItemsControl.

public ref class ItemsPanelTemplate : System::Windows::FrameworkTemplate
public class ItemsPanelTemplate : System.Windows.FrameworkTemplate
type ItemsPanelTemplate = class
    inherit FrameworkTemplate
Public Class ItemsPanelTemplate
Inherits FrameworkTemplate
Herança

Exemplos

Para criar um horizontal ListBox, você pode criar um modelo que especifique um horizontal StackPanel e defini-lo como ItemsPanel a propriedade.To create a horizontal ListBox, you can create a template that specifies a horizontal StackPanel and set it as the ItemsPanel property. O exemplo a seguir mostra ListBox um Style que cria um ListBoxhorizontal.The following example shows a ListBox Style that creates a horizontal ListBox.

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

O exemplo a seguir usa ControlTemplate um para criar um ListBox horizontal que tem cantos arredondados.The following example uses a ControlTemplate to create a horizontal ListBox that has rounded corners. Observe que, neste exemplo, em vez de definir ItemsPanel a propriedade como no exemplo anterior, a StackPanel horizontal é especificada dentro ControlTemplatedo.Note that in this example, instead of setting the ItemsPanel property as in previous example, the horizontal StackPanel is specified within the ControlTemplate. Observe que a IsItemsHost Propriedade está definida como true on StackPanel, indicando que os itens gerados devem estar no painel.Note that the IsItemsHost property is set to true on the StackPanel, indicating that the generated items should go in the panel. Quando você especifica isso dessa forma, o ItemsPanel não pode ser substituído pelo usuário do controle sem usar um. ControlTemplateWhen you specify it this way, the ItemsPanel cannot be replaced by the user of the control without using a ControlTemplate. Portanto, só faça isso se você souber que não quer que o painel seja substituído sem o uso de um modelo.Therefore, only do this if you know you wouldn't 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>

Como alternativa, você pode fazer o seguinte para obter os mesmos resultados.Alternatively, you can do the following to achieve the same results. Nesse caso, o ItemsPresenter cria o painel para o layout dos itens com base no que é especificado ItemsPanelTemplatepelo.In this case, the ItemsPresenter creates the panel for the layout of the items based on what is specified by the 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>

Para obter um exemplo de como usar o estilo e as propriedades de modelagem diferentes ItemsControlno, consulte visão geral de modelagem de dados.For an example of how to use the different styling and templating properties on the ItemsControl, see Data Templating Overview.

Comentários

O ItemsPanelTemplate especifica o painel usado para o layout dos itens.The ItemsPanelTemplate specifies the panel that is used for the layout of items. GroupStyletem uma Panel propriedade que é do tipo ItemsPanelTemplate.GroupStyle has a Panel property that is of type ItemsPanelTemplate. ItemsControlos tipos têm ItemsPanel uma propriedade que é do ItemsPanelTemplatetipo.ItemsControl types have an ItemsPanel property that is of type ItemsPanelTemplate.

Cada ItemsControl tipo tem um padrão ItemsPanelTemplate.Each ItemsControl type has a default ItemsPanelTemplate. Para a ItemsControl classe, o valor ItemsPanel padrão é um ItemsPanelTemplate que especifica um StackPanel.For the ItemsControl class, the default ItemsPanel value is an ItemsPanelTemplate that specifies a StackPanel. Para o ListBox, o padrão usa o VirtualizingStackPanel.For the ListBox, the default uses the VirtualizingStackPanel. Para MenuItem, o padrão usa WrapPanel.For MenuItem, the default uses WrapPanel. Para StatusBar, o padrão usa DockPanel.For StatusBar, the default uses DockPanel.

Construtores

ItemsPanelTemplate()

Inicializa uma instância da classe ItemsPanelTemplate.Initializes an instance of the ItemsPanelTemplate class.

ItemsPanelTemplate(FrameworkElementFactory)

Inicializa uma instância da classe ItemsPanelTemplate com o modelo especificado.Initializes an instance of the ItemsPanelTemplate class with the specified template.

Propriedades

Dispatcher

Obtém o Dispatcher ao qual este DispatcherObject está associado.Gets the Dispatcher this DispatcherObject is associated with.

(Herdado de DispatcherObject)
HasContent

Obtém um valor que indica se este modelo tem conteúdo otimizado.Gets a value that indicates whether this template has optimized content.

(Herdado de FrameworkTemplate)
IsSealed

Obtém um valor que indica se este objeto está em um estado imutável, de modo a não poder ser alterado.Gets a value that indicates whether this object is in an immutable state so it cannot be changed.

(Herdado de FrameworkTemplate)
Resources

Obtém ou define a coleção de recursos que podem ser usados dentro do escopo desse modelo.Gets or sets the collection of resources that can be used within the scope of this template.

(Herdado de FrameworkTemplate)
Template

Obtém ou define uma referência ao objeto que registra ou reproduz os nós XAML para o modelo quando o modelo é definido ou aplicado por um gravador.Gets or sets a reference to the object that records or plays the XAML nodes for the template when the template is defined or applied by a writer.

(Herdado de FrameworkTemplate)
VisualTree

Obtém ou define o nó raiz do modelo.Gets or sets the root node of the template.

(Herdado de FrameworkTemplate)

Métodos

CheckAccess()

Determina se o thread de chamada tem acesso a este DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Herdado de DispatcherObject)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
FindName(String, FrameworkElement)

Localiza o elemento associado ao nome especificado definido neste modelo.Finds the element associated with the specified name defined within this template.

(Herdado de FrameworkTemplate)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
LoadContent()

Carrega o conteúdo do modelo como uma instância de um objeto e retorna o elemento raiz do conteúdo.Loads the content of the template as an instance of an object and returns the root element of the content.

(Herdado de FrameworkTemplate)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
RegisterName(String, Object)

Registra um novo par nome/objeto dentro do escopo de nome atual.Registers a new name/object pair into the current name scope.

(Herdado de FrameworkTemplate)
Seal()

Bloqueia o modelo de modo que ele não pode ser alterado.Locks the template so it cannot be changed.

(Herdado de FrameworkTemplate)
ShouldSerializeResources(XamlDesignerSerializationManager)

Retorna um valor que indica se o processo de serialização deve serializar o valor da propriedade Resources em instâncias desta classe.Returns a value that indicates whether serialization processes should serialize the value of the Resources property on instances of this class.

(Herdado de FrameworkTemplate)
ShouldSerializeVisualTree()

Retorna um valor que indica se o processo de serialização deve serializar o valor da propriedade VisualTree em instâncias desta classe.Returns a value that indicates whether serialization processes should serialize the value of the VisualTree property on instances of this class.

(Herdado de FrameworkTemplate)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
UnregisterName(String)

Remove um mapeamento de nome/objeto do namescope XAML.Removes a name/object mapping from the XAML namescope.

(Herdado de FrameworkTemplate)
ValidateTemplatedParent(FrameworkElement)

Verifica se o pai ao qual o modelo é aplicado é um objeto ItemsPresenter não nulo.Checks that the templated parent is a non-null ItemsPresenter object.

VerifyAccess()

Impõe que o thread de chamada tenha acesso a este DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Herdado de DispatcherObject)

Implantações explícitas de interface

INameScope.FindName(String)

Retorna um objeto que tem o nome de identificação fornecido.Returns an object that has the provided identifying name.

(Herdado de FrameworkTemplate)
IQueryAmbient.IsAmbientPropertyAvailable(String)

Consulta se uma propriedade de ambiente especificada está disponível no escopo atual.Queries whether a specified ambient property is available in the current scope.

(Herdado de FrameworkTemplate)
ISealable.CanSeal (Herdado de FrameworkTemplate)
ISealable.IsSealed (Herdado de FrameworkTemplate)
ISealable.Seal() (Herdado de FrameworkTemplate)

Aplica-se a

Veja também