Application. CreateGroupLevel-Methode (Access)Application.CreateGroupLevel method (Access)

Sie können die CreateGroupLevel -Methode verwenden, um ein Feld oder einen Ausdruck anzugeben, in dem Daten in einem Bericht gruppiert oder sortiert werden sollen.You can use the CreateGroupLevel method to specify a field or expression on which to group or sort data in a report.

SyntaxSyntax

Ausdruck. CreateGroupLevel (_Report_Name, Ausdruck, Kopfzeile, Fußzeile)expression.CreateGroupLevel (ReportName, Expression, Header, Footer)

expression Eine Variable, die ein Application-Objekt darstellt.expression A variable that represents an Application object.

ParameterParameters

NameName Erforderlich/OptionalRequired/Optional DatentypData type BeschreibungDescription
ReportNameReportName ErforderlichRequired StringString Der Name des Berichts, der die neue Gruppenebene enthalten soll.The name of the report that will contain the new group level.
ExpressionExpression ErforderlichRequired StringString Das Feld oder der Ausdruck, nach dem sortiert oder gruppiert werden soll.The field or expression to sort or group on.
HeaderHeader ErforderlichRequired IntegerInteger Gibt an, dass ein Feld oder ein Ausdruck einen Gruppenkopf zugeordnet ist.Indicates that a field or expression will have an associated group header. Wenn das Argument Header auf true festgelegt ist (1), weist das Feld oder der Ausdruck einen Gruppenkopf auf.If the Header argument is True (1), the field or expression will have a group header. Wenn das Argument Header auf false (0) festgelegt ist, wird das Feld oder der Ausdruck nicht.If the Header argument is False (0), the field or expression won't. Sie können eine Kopfzeile erstellen, indem Sie das Argument auf truefestlegen.You can create a header by setting the argument to True.
FooterFooter ErforderlichRequired IntegerInteger Gibt an, dass ein Feld oder ein Ausdruck eine Gruppenfußzeile zugeordnet ist.Indicates a field or expression will have an associated group footer. Wenn das __ Fußzeilen Argument auf true festgelegt ist (1), wird das Feld oder der Ausdruck einen Gruppenfuß haben.If the Footer argument is True (1), the field or expression will have a group footer. Wenn das __ Fußzeilen Argument auf false festgelegt ist (0), wird das Feld oder der Ausdruck nicht.If the Footer argument is False (0), the field or expression won't. Sie können eine Fußzeile erstellen, indem Sie das Argument auf truefestlegen.You can create a footer by setting the argument to True.

RückgabewertReturn value

LongLong

HinweiseRemarks

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.For example, suppose you are building a custom wizard that provides the user with a choice of fields on which to group data when designing a report. Rufen Sie aus dem Assistenten heraus die CreateGroupLevel-Methode auf, um die passenden Gruppen entsprechend der Auswahl des Benutzers zu erstellen.Call the CreateGroupLevel method from your wizard to create the appropriate groups according to the user's choice.

Sie können die CreateGroupLevel-Methode verwenden, wenn Sie einen Assistenten entwickeln, der einen Bericht mit Gruppen oder Summen erstellt.You can use the CreateGroupLevel method when designing a wizard that creates a report with groups or totals. Die CreateGroupLevel-Methode gruppiert oder sortiert Daten nach dem angegebenen Feld oder Ausdruck und erstellt einen Kopf und/oder Fuß für die Gruppierungsebene.The CreateGroupLevel method groups or sorts data on the specified field or expression and creates a header and/or footer for the group level.

Die CreateGroupLevel-Methode steht nur in der Entwurfsansicht eines Berichts zur Verfügung.The CreateGroupLevel method is available only in report Design view.

Microsoft Access verwendet das GroupLevel -Eigenschaftenarray, um die für einen Bericht erstellten Gruppenebenen nachzuverfolgen.Microsoft Access uses the GroupLevel property array to keep track of the group levels created for a report. Durch die CreateGroupLevel-Methode wird dem Array eine neue Gruppenebene hinzugefügt, die auf dem Argument expression basiert.The CreateGroupLevel method adds a new group level to the array, based on the expression argument. Dann wird durch die CreateGroupLevel-Methode ein Indexwert zurückgegeben, der die neue Position der Gruppenebene im Array darstellt.The CreateGroupLevel method then returns an index value that represents the new group level's position in the array. Das erste Feld oder der Ausdruck, nach dem Sie sortieren oder gruppieren, ist Level 0, der zweite ist Level 1 usw.The first field or expression that you sort or group on is level 0, the second is level 1, and so on. Ein Bericht kann bis zu zehn Gruppenebenen (0 bis 9) aufweisen.You can have up to ten group levels in a report (0 to 9).

Wenn Sie angeben, dass das Argument Kopfzeile oder Fußzeile oder beides trueist, werden die Eigenschaften GroupHeader und GroupFooter in einem Bericht auf Ja festgelegt, und für die Gruppenebene wird eine Kopf-und/oder Fußzeile erstellt.When you specify that either the Header or Footer argument, or both, is True, the GroupHeader and GroupFooter properties in a report are set to Yes, and a header and/or footer is created for the group level.

Nachdem eine Kopf-oder Fußzeile erstellt wurde, können Sie andere GroupLevel -Eigenschaften festlegen: GroupOn, GroupInterval und aufeinander. After a header or footer is created, you can set other GroupLevel properties: GroupOn, GroupInterval, and KeepTogether.

Hinweis

Wenn Gruppierungsebenen in einem neuen oder vorhandenen Bericht von Ihrem Assistenten erstellt werden, muss der Bericht in der Entwurfsansicht geöffnet werden.If your wizard creates group levels in a new or existing report, it must open the report in Design view.

BeispielExample

Im folgenden Beispiel wird eine Gruppenebene für ein Feld OrderDate in einem Bericht mit dem Namen OrderReport erstellt.The following example creates a group level on an OrderDate field on a report called OrderReport. Der Bericht, in dem die Gruppenebene erstellt werden soll, muss in der Entwurfsansicht geöffnet sein.The report on which the group level is to be created must be open in Design view. Da die Kopf - __ und Fußzeilen Argumente auf true (1) festgelegt sind, erstellt die-Methode sowohl die Kopf-und Fußzeile für die Gruppenebene.Because the Header and Footer arguments are set to True (1), the method creates both the header and footer for the group level. Die Kopf-und Fußzeile werden dann angepasst.The header and footer are then sized.

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 FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.