Application.CreateGroupLevel-Methode (Access)

Verwenden Sie die CreateGroupLevel-Methode , um ein Feld oder einen Ausdruck anzugeben, nach dem Daten in einem Bericht gruppiert oder sortiert werden sollen.

Syntax

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

expression Eine Variable, die ein Application-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
ReportName	Erforderlich	String	Der Name des Berichts, der die neue Gruppenebene enthalten soll.
Ausdruck	Erforderlich	String	Das Feld oder der Ausdruck, nach dem sortiert oder gruppiert werden soll.
Header	Erforderlich	Integer	Gibt an, dass einem Feld oder Ausdruck ein Gruppenheader zugeordnet ist. Wenn das Header-ArgumentTrue (1) ist, verfügt das Feld oder der Ausdruck über einen Gruppenheader. Wenn das Header-ArgumentFalse (0) ist, wird das Feld oder der Ausdruck nicht verwendet. Sie können einen Header erstellen, indem Sie das Argument auf True festlegen.
Footer	Erforderlich	Integer	Gibt an, dass einem Feld oder Ausdruck eine Gruppenfußzeile zugeordnet ist. Wenn das Footer-ArgumentTrue (1) ist, verfügt das Feld oder der Ausdruck über eine Gruppenfußzeile. Wenn das FußzeilenargumentFalse (0) ist, ist dies für das Feld oder den Ausdruck nicht der Fall. Sie können eine Fußzeile erstellen, indem Sie das Argument auf True festlegen.

Rückgabewert

Long

HinwBemerkungeneise

Angenommen, Sie entwickeln einen Assistenten, der dem Benutzer, wenn er einen Bericht entwirft, die Wahl zwischen mehreren Feldern gibt, nach denen Daten gruppiert werden können. Rufen Sie aus dem Assistenten heraus die CreateGroupLevel-Methode auf, um die passenden Gruppen entsprechend der Auswahl des Benutzers zu erstellen.

Verwenden Sie die CreateGroupLevel-Methode beim Entwerfen eines Assistenten, der einen Bericht mit Gruppen oder Summen erstellt. Die CreateGroupLevel-Methode gruppiert oder sortiert Daten nach dem angegebenen Feld oder Ausdruck und erstellt einen Kopf und/oder Fuß für die Gruppierungsebene.

Die CreateGroupLevel-Methode steht nur in der Entwurfsansicht eines Berichts zur Verfügung.

Microsoft Access verwendet das GroupLevel-Eigenschaftenarray , um die für einen Bericht erstellten Gruppenebenen nachzuverfolgen. Durch die CreateGroupLevel-Methode wird dem Array eine neue Gruppenebene hinzugefügt, die auf dem Argument expression basiert. Dann wird durch die CreateGroupLevel-Methode ein Indexwert zurückgegeben, der die neue Position der Gruppenebene im Array darstellt. Das erste Feld oder der erste Ausdruck, nach dem Sie sortieren oder gruppieren, ist Ebene 0, der zweite ist Ebene 1 usw. Ein Bericht kann bis zu zehn Gruppenebenen (0 bis 9) aufweisen.

Wenn Sie angeben, dass das Header - oder Footer-Argument oder beides true ist, werden die Eigenschaften GroupHeader und GroupFooter in einem Bericht auf Ja festgelegt, und eine Kopf- und/oder Fußzeile wird für die Gruppenebene erstellt.

Nachdem eine Kopf- oder Fußzeile erstellt wurde, können Sie andere GroupLevel-Eigenschaften festlegen: GroupOn, GroupInterval und KeepTogether.

Hinweis

Wenn Gruppierungsebenen in einem neuen oder vorhandenen Bericht von Ihrem Assistenten erstellt werden, muss der Bericht in der Entwurfsansicht geöffnet werden.

Beispiel

Im folgenden Beispiel wird eine Gruppenebene für ein OrderDate-Feld für einen Bericht namens OrderReport erstellt. Der Bericht, auf dem die Gruppenebene erstellt werden soll, muss in der Entwurfsansicht geöffnet sein. Da die Argumente Header und Footer auf True (1) festgelegt sind, erstellt die Methode sowohl die Kopf- als auch die Fußzeile für die Gruppenebene. Die Kopf- und Fußzeile wird dann angepasst.

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

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.