Метод Application.CreateGroupLevel (Access)

Статья
04/07/2023

Используйте метод CreateGroupLevel , чтобы указать поле или выражение, по которым группируются или сортируются данные в отчете.

Синтаксис

expression. CreateGroupLevel (ReportName, Expression, Header, Footer)

выражение: переменная, представляющая объект Application.

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
ReportName	Обязательный	String	Имя отчета, который будет содержать новый уровень группы.
Expression	Обязательный	String	Поле или выражение для сортировки или группировки.
Header	Обязательный	Integer	Указывает, что поле или выражение будет иметь связанный заголовок группы. Если аргумент Header имеет значение True (1), поле или выражение будет иметь заголовок группы. Если аргумент Заголовка имеет значение False (0), поле или выражение не будет. Вы можете создать заголовок, задав для аргумента значение True.
Footer	Обязательный	Integer	Указывает, что поле или выражение будет иметь связанный нижний колонтитул группы. Если аргумент Нижний колонтитул имеет значение True (1), поле или выражение будет иметь нижний колонтитул группы. Если аргумент нижнего колонтитула имеет значение False (0), поле или выражение не будет. Нижний колонтитул можно создать, задав для аргумента значение True.

Возвращаемое значение

Длинное целое

Замечания

Например, предположим, что вы создаете пользовательский мастер, который предоставляет пользователю выбор полей для группирования данных при разработке отчета. Вызовите метод CreateGroupLevel из мастера, чтобы создать соответствующие группы по выбору пользователя.

Используйте метод CreateGroupLevel при проектировании мастера, который создает отчет с группами или итоговыми значениями. Метод CreateGroupLevel группирует или сортирует данные по указанному полю или выражению и создает верхний и/или нижний колонтитул для уровня группы.

Метод CreateGroupLevel доступен только в режиме конструктора отчета.

Microsoft Access использует массив свойств GroupLevel для отслеживания уровней групп, созданных для отчета. Метод CreateGroupLevel добавляет в массив новый уровень группы на основе аргумента выражения . Затем метод CreateGroupLevel возвращает значение индекса, представляющее позицию нового уровня группы в массиве. Первое поле или выражение, по которому выполняется сортировка или группировка, — уровень 0, второе — уровень 1 и т. д. В отчете может быть до десяти уровней группы (от 0 до 9).

Если указать, что аргумент Верхний или Нижний колонтитул или оба значения имеют значение True, для свойств GroupHeader и GroupFooter в отчете задается значение Да, а для уровня группы создаются колонтитулы и (или) нижние колонтитулы.

После создания верхнего или нижнего колонтитула можно задать другие свойства GroupLevel : GroupOn, GroupInterval и KeepTogether.

Примечание.

Если мастер создает уровни групп в новом или существующем отчете, он должен открыть отчет в режиме конструктора.

Пример

В следующем примере создается уровень группы в поле OrderDate в отчете с именем OrderReport. Отчет, на котором должен быть создан уровень группы, должен быть открыт в режиме конструктора. Так как аргументы верхнего и нижнегоколонтитулов имеют значение 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 и обратная связь.