Report.ApplyFilter 事件 (Access)

會在篩選套用至報表時發生。

語法

運算式。ApplyFilter (Cancel、 ApplyType)

表達 代表 Report 物件的變數。

參數

名稱	必要/選用	資料類型	描述
Cancel	必要	整數	設定決定 ApplyFilter 事件會發生。 Cancel引數設定為 True 取消 ApplyFilter 事件和報表不套用篩選。
ApplyType	必要	整數	會傳回已套用之篩選的類型。

註解

發生此事件時若要執行巨集或事件程序，請將 OnApplyFilter 屬性設定為巨集的名稱或 [事件程序]。

使用 ApplyFilter 事件來：

• 請確定正在套用的篩選準則正確無誤。 例如，您可能想要確定任何套用至 Orders 報表的篩選都包含限制 OrderDate 字 段的準則。 若要這樣做，請檢查報表的 Filter 或 ServerFilter 屬性值，以確定 WHERE 子句運算式中包含此準則。

• 在套用篩選之前，變更報表的顯示。 例如，當您套用特定篩選時，可能想要停用或隱藏不適合此篩選所顯示之記錄使用的部分欄位。

• 復原或變更您在 Filter 事件發生時 所採取的動作。 例如，當使用者建立篩選準則時，您可以停用或隱藏報表上的某些控制項，因為您不希望這些控制項包含在篩選準則中。 在套用篩選之後，您可以啟用或顯示這些控制項。

ApplyFilter事件程序或宏中的動作會在套用或移除篩選之前發生，或是在關閉 [進階篩選/排序] 視窗之後，但在重新顯示報表之前發生。 您在新建立的篩選準則中輸入的準則，可供 ApplyFilter 事件程序或宏作為 Filter 或 ServerFilter 屬性的設定。

ApplyFilter 事件不會發生當使用者執行下列其中一項：

• 使用宏中的 ApplyFilter、OpenReport 或 ShowAllRecords 巨集指令，或 Visual Basic 中 DoCmd 物件的對應方法，套用或移除篩選。

• 使用DoCmd物件的 Close 巨集指令或Close方法來關閉 [進階篩選/排序] 視窗。

• 設定宏或 Visual Basic (中的 Filter 或 ServerFilter 屬性或 FilterOn 屬性，雖然您可以在 ApplyFilter 事件程序或宏) 中設定這些屬性。

支援和意見反應

有關於 Office VBA 或這份文件的問題或意見反應嗎？ 如需取得支援服務並提供意見反應的相關指導，請參閱 Office VBA 支援與意見反應。