Application.CreateGroupLevel メソッド (Access)

  • [アーティクル]

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

構文

式。CreateGroupLevel (ReportName、 式、 ヘッダー、 フッター)

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

パラメーター

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

戻り値

Long

注釈

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

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

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

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

Header 引数または Footer 引数、またはその両方を True に指定すると、レポート内の GroupHeader プロパティと GroupFooter プロパティが [はい] に設定され、グループ レベルに対してヘッダーまたはフッターが作成されます。

ヘッダーまたはフッターを作成した後、GroupOn、GroupInterval、KeepTogether の他の GroupLevel プロパティを設定できます。

注:

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

例

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