Application.CreateGroupLevel 方法 (Access)

使用 CreateGroupLevel 方法可指定要对其对报表中的数据进行分组或排序的字段或表达式。

语法

表达式CreateGroupLevel (ReportName表达式页眉页脚)

expression:表示 Application 对象的变量。

参数

名称 必需/可选 数据类型 说明
ReportName 必需 字符串 将包含新组级别的报表的名称。
Expression 必需 String 排序或分组所依据的字段或排达式。
Header 必需 Integer 指示字段或表达式将具有关联的组标头。 如果 Header 参数为 True (1) ,则字段或表达式将具有组标头。 如果 Header 参数为 False (0) ,则字段或表达式不会。 您可以通过将参数设置为 True 来创建页眉。
Footer 必需 Integer 表示将具有相关联的组页脚的字段或表达式。 如果 Footer 参数为 True (1) ,则字段或表达式将具有组页脚。 如果 Footer 参数为 False (0) ,则字段或表达式不会。 您可以通过将参数设置为 True 来创建页脚。

返回值

Long

备注

例如,假设要生成一个自定义向导设计报表时为用户提供一种在其上对数据进行分组的字段。 从向导来创建相应的组,根据用户的选择调用 CreateGroupLevel 方法。

设计创建包含组或总计的报表的向导时,请使用 CreateGroupLevel 方法。 CreateGroupLevel 方法分组或排序的指定的字段或表达式的数据并创建页眉和/或页脚所在的分组级别。

CreateGroupLevel 方法是仅在报表设计视图中可用。

Microsoft Access 使用 GroupLevel 属性数组来跟踪为报表创建的组级别。 CreateGroupLevel 方法将新的分组级别添加到数组中,并根据 expression参数。 CreateGroupLevel 方法然后返回一个索引值,表示新的分组级别数组中的位置。 排序或分组的第一个字段或表达式是级别 0,第二个字段或表达式是级别 1,依此类说。 在一个报表中,最多可具有 10 个组级别(0 至 9)。

如果指定 “页眉”“页脚 ”参数或两者均为 True,则报表中的 GroupHeaderGroupFooter 属性将设置为“是”,并为组级别创建页眉和/或页脚。

创建页眉或页脚后,可以设置其他 GroupLevel 属性: GroupOnGroupIntervalKeepTogether

注意

如果向导在一个新的或现有报表中创建分组级别,它必须在设计视图中打开该报表。

示例

以下示例在名为 OrderReport 的报表的 OrderDate 字段上创建组级别。 要在其中创建分组级别的报表必须在设计视图中打开。 由于 HeaderFooter 参数设置为 True (1) ,因此该方法为组级别创建页眉和页脚。 然后可以设置页眉和页脚的大小。

Sub CreateGL() 
 Dim varGroupLevel As Variant 
 
 ' Create new group level on OrderDate field. 
 varGroupLevel = CreateGroupLevel("OrderReport", "OrderDate", _ 
 True, True) 
 ' Set height of header/footer sections. 
 Reports!OrderReport.Section(acGroupLevel1Header).Height = 400 
 Reports!OrderReport.Section(acGroupLevel1Footer).Height = 400 
End Sub

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈? 请参阅 Office VBA 支持和反馈,获取有关如何接收支持和提供反馈的指南。