Report.GroupLevel property (Access)

You can use the GroupLevel property in Visual Basic to refer to the group level that you are grouping or sorting on in a report. Read-only GroupLevel object.

Syntax

expression.GroupLevel (Index)

expression A variable that represents a Report object.

Parameters

Name Required/Optional Data type Description
Index Required Long The group level, starting with 0. The first field or expression that you group on is group level 0, the second is group level 1, and so on.

Remarks

The following sample settings show how you use the GroupLevel property to refer to a group level.

Group level Refers to
GroupLevel (0) The first field or expression that you sort or group on.
GroupLevel (1) The second field or expression that you sort or group on.
GroupLevel (2) The third field or expression that you sort or group on.

The GroupLevel property setting is an array in which each entry identifies a group level. You can have up to 10 group levels (0 to 9).

Note

You can use this property only by using Visual Basic to set the SortOrder, GroupOn, GroupInterval, KeepTogether, and ControlSource properties. You set these properties in the Open event procedure of a report.

In reports, you can group or sort on more than one field or expression. Each field or expression that you group or sort on is a group level.

You specify the fields and expressions to sort and group on by using the CreateGroupLevel method.

If a group is already defined for a report (the GroupLevel property is set to 0), you can use the ControlSource property to change the group level in the report's Open event procedure.

Example

The following code changes the ControlSource property to a value contained in the txtPromptYou text box on the open form named SortForm.

Private Sub Report_Open(Cancel As Integer) 
 Me.GroupLevel(0).ControlSource _ 
 = Forms!SortForm!txtPromptYou 
End Sub

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.