CreateGroupLevel メソッド (Access)Application.CreateGroupLevel method (Access)

CreateGroupLevelメソッドを使用すると、レポート内のデータをグループ化または並べ替えするフィールドまたは式を指定できます。You can use the CreateGroupLevel method to specify a field or expression on which to group or sort data in a report.

構文Syntax

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

expression**Application** オブジェクトを 表す変数。expression A variable that represents an Application object.

パラメーターParameters

名前Name 必須 / オプションRequired/Optional データ型Data type 説明Description
ReportNameReportName 必須Required StringString 新しいグループレベルが含まれるレポートの名前を指定します。The name of the report that will contain the new group level.
ExpressionExpression 必須Required StringString 並べ替えやグループ化の基準となるフィールドまたは式を指定します。The field or expression to sort or group on.
HeaderHeader 必須Required 整数型 (Integer)Integer フィールドまたは式に、関連付けられたグループヘッダーがあることを示します。Indicates that a field or expression will have an associated group header. 引数_Header_にTrue (1) を指定すると、フィールドまたは式にはグループヘッダーが設定されます。If the Header argument is True (1), the field or expression will have a group header. _Header_引数がFalse (0) の場合、フィールドまたは式はありません。If the Header argument is False (0), the field or expression won't. ヘッダーを作成するには、引数を True に設定します。You can create a header by setting the argument to True.
FooterFooter 必須Required 整数型 (Integer)Integer フィールドまたは式はグループ フッターを関連付けることを示します。Indicates a field or expression will have an associated group footer. 引数_Footer_にTrue (1) を指定すると、フィールドまたは式にはグループフッターが設定されます。If the Footer argument is True (1), the field or expression will have a group footer. 引数_Footer_にFalse (0) を指定すると、フィールドまたは式は表示されません。If the Footer argument is False (0), the field or expression won't. フッターを作成するには、引数を True に設定します。You can create a footer by setting the argument to True.

戻り値Return value

LongLong

解説Remarks

たとえば、レポートのデザイン時に、データをグループ化するためのフィールドを選べるカスタム ウィザードを作成しているとします。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. ウィザードから CreateGroupLevel メソッドを呼び出して、選んだ項目に従って適切なグループ化を行うことができます。Call the CreateGroupLevel method from your wizard to create the appropriate groups according to the user's choice.

CreateGroupLevel メソッドを使って、グループ化されたデータや合計を表示するレポートを作成するウィザードをデザインできます。You can use the CreateGroupLevel method when designing a wizard that creates a report with groups or totals. CreateGroupLevel メソッドを使って、指定したフィールドまたは式によるデータの並べ替えやグループ化を行い、グループ レベルのヘッダーやフッターを作成できます。The CreateGroupLevel method groups or sorts data on the specified field or expression and creates a header and/or footer for the group level.

CreateGroupLevel メソッドは、レポートのデザイン ビューで使います。The CreateGroupLevel method is available only in report Design view.

Access では**GroupLevel** プロパティの配列を使用して、レポートに対して作成されたグループレベルを追跡します。Microsoft Access uses the GroupLevel property array to keep track of the group levels created for a report. CreateGroupLevel メソッドは、引数 expression を基に新しいグループ レベルを配列に追加します。The CreateGroupLevel method adds a new group level to the array, based on the expression argument. CreateGroupLevel メソッドは、新しいグループ レベルの配列内の位置を示すインデックスの値を返します。The CreateGroupLevel method then returns an index value that represents the new group level's position in the array. 並べ替えまたはグループ化する最初のフィールドまたは式はレベル0、2番目はレベル1のようになります。The first field or expression that you sort or group on is level 0, the second is level 1, and so on. 1 つのレポートで、グループ レベルを 10 個 (0 から 9) まで作成できます。You can have up to ten group levels in a report (0 to 9).

引数_header_または_footer_を指定するか、またはその両方をTrueに設定すると、レポートの**GroupHeader** プロパティと**GroupFooter** プロパティは [Yes/はい] に設定され、ヘッダーまたはフッターがグループレベルで作成されます。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.

ヘッダーまたはフッターを作成した後、他のGroupLevelプロパティ ( GroupOnGroupInterval、および**KeepTogether**) を設定できます。After a header or footer is created, you can set other GroupLevel properties: GroupOn, GroupInterval, and KeepTogether.

注意

ウィザードを使ってレポートにグループ レベルを作成する場合、レポートはデザイン ビューで開いておく必要があります。If your wizard creates group levels in a new or existing report, it must open the report in Design view.

Example

次の使用例は、OrderReport というレポートの [受注日] フィールドにグループレベルを作成します。The following example creates a group level on an OrderDate field on a report called OrderReport. グループ レベルを作成するレポートは、デザイン ビューで開く必要があります。The report on which the group level is to be created must be open in Design view. _ヘッダー_および_フッター_の引数はTrue (1) に設定されているため、このメソッドはグループレベルのヘッダーとフッターの両方を作成します。Because the Header and Footer arguments are set to True (1), the method creates both the header and footer for the group level. ヘッダーとフッターのサイズを変更します。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 and feedback

Office VBA またはこの説明書に関するご質問やフィードバックがありますか?Have questions or feedback about Office VBA or this documentation? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.