GroupStyle 类

定义

介绍如何显示集合中的分组项,例如 GroupItems 中的集合。

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class GroupStyle : INotifyPropertyChanged
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class GroupStyle : INotifyPropertyChanged
Public Class GroupStyle
Implements INotifyPropertyChanged
<GroupStyle />
继承
Object IInspectable GroupStyle
属性
实现

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

此处,GroupStyle 应用于包含分组数据的 GridView 控件。 有关详细信息,并查看完整的示例代码,请参阅 如何对列表或网格中的项进行分组

<GridView ItemsSource="{Binding Source={StaticResource cvsProjects}}" 
  Margin="0,120,0,0" MaxHeight="500" Grid.Column="1">
    <GridView.ItemTemplate>
        <DataTemplate>
            <StackPanel Margin="20">
                <TextBlock Text="{Binding Name}" FontWeight="Bold" 
                           Style="{StaticResource BaseTextBlockStyle}"/>
                <TextBlock Text="{Binding DueDate}" TextWrapping="NoWrap" 
                           Style="{StaticResource BodyTextBlockStyle}" />
                <CheckBox Content="Complete" IsChecked="{Binding Complete}" 
                          IsEnabled="False"/>
            </StackPanel>
        </DataTemplate>
    </GridView.ItemTemplate>
    <GridView.ItemsPanel>
        <ItemsPanelTemplate>
            <ItemsWrapGrid MaximumRowsOrColumns="3"/>
        </ItemsPanelTemplate>
    </GridView.ItemsPanel>

    <GridView.GroupStyle>
        <GroupStyle HidesIfEmpty="True">
            <GroupStyle.HeaderTemplate>
                <DataTemplate>
                    <Grid Background="LightGray" Margin="0">
                        <TextBlock Text='{Binding Name}' 
                                   Foreground="Black" Margin="30"
                                   Style="{StaticResource HeaderTextBlockStyle}"/>
                    </Grid>
                </DataTemplate>
            </GroupStyle.HeaderTemplate>

        </GroupStyle>
    </GridView.GroupStyle>
</GridView>

注解

GroupStyle 通常在 Extensible Application Markup Language (XAML) 中定义,然后设置为 ItemsControl.GroupStyle 属性的值来定义组的视觉外观。

构造函数

GroupStyle()

初始化 GroupStyle 类的新实例。

属性

ContainerStyle

注意

ContainerStyle 在Windows 8.1后可能会更改或不可用,并且 ItemsControl.GroupStyle 不支持。

获取或设置应用于为每个项生成的 GroupItem 的样式。

ContainerStyleSelector

注意

ContainerStyleSelector 在Windows 8.1后可能会更改或不可用,并且 ItemsControl.GroupStyle 不支持。

获取或设置对自定义 StyleSelector 逻辑类的引用。 此属性引用的 StyleSelector 返回要应用于每个生成的 GroupItem 的样式。

HeaderContainerStyle

获取或设置应用于每个项的标头的样式。

HeaderTemplate

获取或设置用于显示组标题的模板。

HeaderTemplateSelector

获取或设置对自定义 DataTemplateSelector 逻辑类的引用。 DataTemplateSelector 返回不同的 DataTemplate 值,用于组项内容的标头区域。

HidesIfEmpty

获取或设置一个值,该值指示是否应该显示与空组相对应的项。

Panel

获取或设置一个模板,该模板创建用于布局项的面板。

事件

PropertyChanged

在属性值更改时发生。

适用于

另请参阅