DoCmd.SetFilter メソッド (Access)

  • [アーティクル]

SetFilter メソッドを使用して、アクティブなデータシート、フォーム、レポート、またはテーブルのレコードにフィルターを適用します。

構文

式。SetFilter (FilterName、 WhereCondition、 ControlName)

expression: DoCmd オブジェクトを表す変数。

パラメーター

名前 必須 / オプション データ型 説明
FilterName 省略可能 バリアント型 (Variant) 指定した場合は、クエリの名前、またはクエリとして保存されているフィルターの名前。 この引数または WhereCondition 引数が必要です。
WhereCondition 省略可能 バリアント型 (Variant) 指定した場合は、データシート、フォーム、レポート、またはテーブルのレコードを制限する SQL WHERE 句。
ControlName 省略可能 バリアント型 (Variant) 指定した場合は、フィルター処理するサブフォームまたはサブレポートに対応するコントロールの名前を示します。 指定しない場合は、現在のオブジェクトがフィルター処理されます。

注釈

このメソッドを実行すると、現在アクティブで、フォーカスを持っているテーブル、フォーム、レポート、またはデータシート (たとえばクエリ結果) にフィルターが適用されます。

アクティブ オブジェクトの Filter プロパティを使用して WhereCondition 引数を保存し、後で適用します。 フィルターは、それを作成したオブジェクトに保存されます。 そのオブジェクトが開くと自動的に読み込まれますが、自動的に適用されることはありません。

オブジェクトを開いたときにフィルターを自動的に適用するには、 FilterOnLoad プロパティを True に設定 します。

例

次のコード例では、"NWTB" で始まるレコードのみを表示するように、アクティブなオブジェクトをフィルター処理します。

DoCmd.SetFilter WhereCondition:="[Product Code] Like ""NWTB*"""

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。