レポートにフィルターが適用されると発生します。
構文
式。ApplyFilter (キャンセル、 ApplyType)
式: Report オブジェクトを表す変数。
パラメーター
| 名前 | 必須 / オプション | データ型 | 説明 |
|---|---|---|---|
| Cancel | 必須 | 整数型 (Integer) | ApplyFilter イベントを発生させるかどうかを設定します。 引数 Cancel を True に設定すると、 ApplyFilter イベントが取り消されて、レポートにフィルターが適用されません。 |
| ApplyType | 必須 | 整数型 (Integer) | 適用されたフィルターの種類を返します。 |
注釈
このイベントが発生したときに、マクロまたはイベント プロシージャを実行するには、" OnApplyFilter /フィルター実行時" プロパティをマクロ名または [イベント プロシージャ] に設定します。
ApplyFilter イベントを使用して、以下の操作を行います。
適用しているフィルターが正しいことを確認します。 たとえば、 "受注" レポートに適用されるフィルターに "受注日 " フィールドを制限する抽出条件が含まれていることを確認したい場合があります。 これを行うには、レポートの Filter プロパティまたは ServerFilter プロパティの値をチェックして、この条件が WHERE 句式に含まれていることを確認します。
フィルターを適用する前にレポートの表示を変更します。 たとえば、特定のフィルターを適用する場合に、表示されるレコードに必要のないフィールドを非表示または使用不可にします。
Filter イベントの発生時に実行した操作を元に戻すか、変更します。 たとえば、ユーザーがフィルターを作成するときに、レポートの一部のコントロールをフィルター条件に含めたくないため、これらのコントロールを無効にしたり、非表示にしたりできます。 フィルターを適用した後、これらのコントロールを有効または表示できます。
ApplyFilter イベント プロシージャまたはマクロのアクションは、フィルターが適用または削除される前、または高度なフィルター/並べ替えウィンドウが閉じられた後、レポートが再表示される前に発生します。 新しく作成したフィルターに入力した条件は、 ApplyFilter イベント プロシージャまたはマクロで Filter または ServerFilter プロパティの設定として使用できます。
ApplyFilter イベントは、以下のいずれかの操作を実行したときには発生しません。
マクロの ApplyFilter、OpenReport、ShowAllRecords アクション、または Visual Basic の DoCmd オブジェクトの対応するメソッドを使用して、フィルターを適用または削除します。
"Close/閉じる" アクションまたは DoCmd オブジェクトの Close メソッドを使って、[フィルター/並べ替えの編集] ウィンドウを閉じたとき。
マクロまたは Visual Basic で Filter プロパティまたは ServerFilter プロパティまたは FilterOn プロパティを設定します (ただし、これらのプロパティは ApplyFilter イベント プロシージャまたはマクロで設定できます)。
サポートとフィードバック
Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。