Application.CreateGroupLevel メソッド (Access)

レポート内のデータをグループ化または並べ替えるフィールドまたは式を指定するには、 CreateGroupLevel メソッドを使用します。

構文

CreateGroupLevel (ReportName, Expression, Header, Footer)

expressionApplication オブジェクトを 表す変数。

パラメーター

名前 必須 / オプション データ型 説明
ReportName 必須 String 新しいグループ レベルを含むレポートの名前。
Expression 必須 String 並べ替えやグループ化の基準となるフィールドまたは式を指定します。
Header 必須 Integer フィールドまたは式にグループ ヘッダーが関連付けられることを示します。 ヘッダー 数が True (1) の場合、フィールドまたは式にはグループ ヘッダーが含まれます。 ヘッダー 数が False (0) の場合、フィールドまたは式はそうではありません。 ヘッダーを作成するには、引数を True に設定します。
Footer 必須 整数型 (Integer) フィールドまたは式はグループ フッターを関連付けることを示します。 フッター引数が True (1) の場合、フィールドまたは式にはグループ フッターが含まれます。 フッター引数が False (0) の場合、フィールドまたは式は無効になります。 フッターを作成するには、引数を True に設定します。

戻り値

Long

注釈

たとえば、レポートのデザイン時に、データをグループ化するためのフィールドを選べるカスタム ウィザードを作成しているとします。 ウィザードから CreateGroupLevel メソッドを呼び出して、選んだ項目に従って適切なグループ化を行うことができます。

グループまたは集計を含むレポートを作成するウィザードを設計する場合は、 CreateGroupLevel メソッドを使用します。 CreateGroupLevel メソッドを使って、指定したフィールドまたは式によるデータの並べ替えやグループ化を行い、グループ レベルのヘッダーやフッターを作成できます。

CreateGroupLevel メソッドは、レポートのデザイン ビューで使います。

Microsoft Access では、 GroupLevel プロパティ配列を使用して、レポート用に作成されたグループ レベルを追跡します。 CreateGroupLevel メソッドは、引数 expression を基に新しいグループ レベルを配列に追加します。 CreateGroupLevel メソッドは、新しいグループ レベルの配列内の位置を示すインデックスの値を返します。 並べ替えまたはグループ化する最初のフィールドまたは式はレベル 0、2 番目はレベル 1、というように続きます。 1 つのレポートで、グループ レベルを 10 個 (0 から 9) まで作成できます。

ヘッダー数またはフッター引数のどちらか一方、あるいは両方が True に指定すると、レポート内の GroupHeader プロパティと GroupFooter プロパティは Yes に設定され、グループ レベルでヘッダーやフッターが作成されます。

ヘッダーまたはフッターを作成した後、他の GroupLevel プロパティ ( GroupOnGroupIntervalおよび KeepTogether) を設定できます。

注:

ウィザードを使ってレポートにグループ レベルを作成する場合、レポートはデザイン ビューで開いておく必要があります。

次の例では、[受注レポート] というレポートの [受注日 ] フィールドにグループ レベルを作成します。 グループ レベルを作成するレポートは、デザイン ビューで開く必要があります。 Header および Footer 引数が 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 のサポートおよびフィードバックを参照してください。