GroupStyle Classe

Definição

Define qual você deseja que seja a aparência do grupo em cada nível.Defines how you want the group to look at each level.

public ref class GroupStyle : System::ComponentModel::INotifyPropertyChanged
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public class GroupStyle : System.ComponentModel.INotifyPropertyChanged
type GroupStyle = class
    interface INotifyPropertyChanged
Public Class GroupStyle
Implements INotifyPropertyChanged
Herança
GroupStyle
Atributos
Implementações

Exemplos

Os exemplos a seguir mostram um ItemsControl associado a um XmlDataProvider e o conteúdo code-behind que contém a lógica para adicionar e remover o agrupamento.The following examples show an ItemsControl that is bound to an XmlDataProvider and the code-behind content that contains the logic to add and remove grouping. Quando a caixa de seleção está marcada, o conteúdo da ItemsControl é agrupado pelo atributo Type.When the check box is checked, the content of the ItemsControl is grouped by the Type attribute.

Cada grupo é do tipo CollectionViewGroup.Each group is of type CollectionViewGroup. O HeaderTemplate de GroupStyle é especificado para que ele apareça como um TextBlock que exibe a Name de cada grupo.The GroupStyle HeaderTemplate is specified so that it appears as a TextBlock that displays the Name of each the group. Nesse caso, a Name é Work ou Home.In this case, the Name is either Work or Home.

<Window x:Class="GroupingSample.Window1"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    Title="Grouping Sample"
    Width="220" Height="550">
  <StackPanel>

    <StackPanel.Resources>
      <XmlDataProvider x:Key="myTasks" XPath="Tasks/Task">
        <x:XData>
          <Tasks xmlns="">
            <Task Name="Groceries" Priority="2" Type="Home">
              <Description>Pick up Groceries and Detergent</Description>
            </Task>
            <Task Name="Laundry" Priority="2" Type="Home">
              <Description>Do Laundry</Description>
            </Task>
            <Task Name="Email" Priority="1" Type="Work">
              <Description>Email Clients</Description>
            </Task>
            <Task Name="Clean" Priority="3" Type="Work">
              <Description>Clean my office</Description>
            </Task>
            <Task Name="Dinner" Priority="1" Type="Home">
              <Description>Get ready for family reunion</Description>
            </Task>
            <Task Name="Proposals" Priority="2" Type="Work">
              <Description>Review new budget proposals</Description>
            </Task>
          </Tasks>
        </x:XData>
      </XmlDataProvider>
    </StackPanel.Resources>

    <TextBlock Margin="12,5,5,0" FontSize="20" Text="My Task List"/>
    <CheckBox Margin="10,5,5,10" Checked="AddGrouping"
              Unchecked="RemoveGrouping">Group by task type</CheckBox>
    <ItemsControl Margin="10" Name="myItemsControl"
                  ItemsSource="{Binding Source={StaticResource myTasks}}">
      <ItemsControl.ItemTemplate>
        <DataTemplate>
          <DataTemplate.Resources>
            <Style TargetType="TextBlock">
              <Setter Property="FontSize" Value="18"/>
              <Setter Property="HorizontalAlignment" Value="Center"/>
            </Style>
          </DataTemplate.Resources>
          <Grid>
            <Ellipse Fill="Silver"/>
            <StackPanel>
              <TextBlock Margin="3,3,3,0"
                         Text="{Binding XPath=@Name}"/>
              <TextBlock Margin="3,0,3,7"
                         Text="{Binding XPath=@Priority}"/>
            </StackPanel>
          </Grid>
        </DataTemplate>
      </ItemsControl.ItemTemplate>
      <ItemsControl.ItemContainerStyle>
        <Style>
          <Setter Property="Control.Width" Value="100"/>
          <Setter Property="Control.Margin" Value="5"/>
        </Style>
      </ItemsControl.ItemContainerStyle>
      <ItemsControl.GroupStyle>
        <GroupStyle>
          <GroupStyle.HeaderTemplate>
            <DataTemplate>
              <TextBlock FontWeight="Bold" FontSize="15"
                         Text="{Binding Path=Name}"/>
            </DataTemplate>
          </GroupStyle.HeaderTemplate>
        </GroupStyle>
      </ItemsControl.GroupStyle>
    </ItemsControl>
  </StackPanel>
</Window>
using System;
using System.Windows;
using System.Windows.Data;

namespace GroupingSample
{
    public partial class Window1 : System.Windows.Window
    {

        public Window1()
        {
            InitializeComponent();
        }

        CollectionView myView;
        private void AddGrouping(object sender, RoutedEventArgs e)
        {
            myView = (CollectionView)CollectionViewSource.GetDefaultView(myItemsControl.ItemsSource);
            if (myView.CanGroup == true)
            {
                PropertyGroupDescription groupDescription
                    = new PropertyGroupDescription("@Type");
                myView.GroupDescriptions.Add(groupDescription);
            }
            else
            {
                return;
            }
        }

        private void RemoveGrouping(object sender, RoutedEventArgs e)
        {
            myView = (CollectionView)CollectionViewSource.GetDefaultView(myItemsControl.ItemsSource);
            myView.GroupDescriptions.Clear();
        }
    }
}

Imports System.Windows
Imports System.Windows.Data

Namespace GroupingSample
    Partial Public Class Window1
        Inherits System.Windows.Window

        Public Sub New()
            InitializeComponent()
        End Sub

        Private myView As CollectionView
        Private Sub AddGrouping(ByVal sender As Object, ByVal e As RoutedEventArgs)
            myView = CType(CollectionViewSource.GetDefaultView(myItemsControl.ItemsSource), CollectionView)
            If myView.CanGroup = True Then
                Dim groupDescription As New PropertyGroupDescription("@Type")
                myView.GroupDescriptions.Add(groupDescription)
            Else
                Return
            End If
        End Sub

        Private Sub RemoveGrouping(ByVal sender As Object, ByVal e As RoutedEventArgs)
            myView = CType(CollectionViewSource.GetDefaultView(myItemsControl.ItemsSource), CollectionView)
            myView.GroupDescriptions.Clear()
        End Sub
    End Class
End Namespace

Construtores

GroupStyle()

Inicializa uma nova instância da classe GroupStyle.Initializes a new instance of the GroupStyle class.

Campos

DefaultGroupPanel

Identifica o ItemsPanelTemplate padrão que cria o painel usado para criar o layout dos itens.Identifies the default ItemsPanelTemplate that creates the panel used to layout the items.

Propriedades

AlternationCount

Obtém ou define o número de objetos GroupItem alternados.Gets or sets the number of alternating GroupItem objects.

ContainerStyle

Obtém ou define o estilo aplicado ao GroupItem gerado de cada item.Gets or sets the style that is applied to the GroupItem generated for each item.

ContainerStyleSelector

Permite que o gravador de aplicativos forneça lógica de seleção personalizada para um estilo a ser aplicado a cada GroupItem gerado.Enables the application writer to provide custom selection logic for a style to apply to each generated GroupItem.

Default

Especifica o estilo padrão do grupo.Gets the default style of the group.

HeaderStringFormat

Obtém ou define uma cadeia de caracteres de composição que especifica como formatar o cabeçalho, se ele é exibido como uma cadeia de caracteres.Gets or sets a composite string that specifies how to format the header if it is displayed as a string.

HeaderTemplate

Obtém ou define o modelo usado para exibir o cabeçalho do grupo.Gets or sets the template that is used to display the group header.

HeaderTemplateSelector

Permite que o gravador de aplicativos forneça lógica de seleção personalizada para um modelo usado para exibir o cabeçalho de grupo.Enables the application writer to provide custom selection logic for a template that is used to display the group header.

HidesIfEmpty

Obtém ou define um valor que indica se os itens correspondentes a grupos vazios devem ser exibidos.Gets or sets a value that indicates whether items corresponding to empty groups should be displayed.

Panel

Obtém ou define um modelo que cria o painel usado para criar o layout dos itens.Gets or sets a template that creates the panel used to layout the items.

Métodos

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)
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)
MemberwiseClone()

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

(Herdado de Object)
OnPropertyChanged(PropertyChangedEventArgs)

Aciona o evento PropertyChanged usando os argumentos fornecidos.Raises the PropertyChanged event using the provided arguments.

ToString()

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

(Herdado de Object)

Eventos

PropertyChanged

Ocorre quando um valor de propriedade é alterado.Occurs when a property value changes.

Implantações explícitas de interface

INotifyPropertyChanged.PropertyChanged

Ocorre quando um valor de propriedade é alterado.Occurs when a property value changes.

Aplica-se a

Veja também