會在篩選套用至報表時發生。
語法
表達。ApplyFilter (Cancel、ApplyType)
詞 代表 Report 物件的變數。
參數
| 名稱 | 必要/選用 | 資料類型 | 描述 |
|---|---|---|---|
| Cancel | 必要 | 整數 | 設定決定 ApplyFilter 事件會發生。 Cancel引數設定為 True 取消 ApplyFilter 事件和報表不套用篩選。 |
| 應用類型 | 必要 | 整數 | 會傳回已套用之篩選的類型。 |
註解
發生此事件時若要執行巨集或事件程序，請將 OnApplyFilter 屬性設定為巨集的名稱或 [事件程序]。
使用 ApplyFilter 事件來：
請確定正在套用的過濾器正確無誤。 例如，您可能想要確定套用至 「訂單」 報表的任何篩選器都包含限制 「訂單日期」 欄位的準則。 若要這樣做，請檢查報表的 Filter 或 ServerFilter 屬性值，以確保此準則包含在 WHERE 子句運算式中。
在套用篩選之前，變更報表的顯示。 例如，當您套用特定篩選時，可能想要停用或隱藏不適合此篩選所顯示之記錄使用的部分欄位。
復原或變更您在 發生篩選 事件時採取的動作。 例如，您可以在使用者建立篩選條件時停用或隱藏報表上的某些控制項，因為您不希望這些控制項包含在篩選條件中。 在套用篩選之後，您可以啟用或顯示這些控制項。
「 ApplyFilter 」事件程序或巨集中的動作會在套用或移除過濾器之前，或在關閉「進階過濾器/排序」視窗之後，但在重新顯示報告之前發生。 您在新建立的篩選器中輸入的準則可供 ApplyFilter 事件程序或巨集使用，作為 Filter 或 ServerFilter 屬性的設定。
ApplyFilter 事件不會發生當使用者執行下列其中一項：
使用巨集中的 ApplyFilter、OpenReport 或 ShowAllRecords 動作，或使用 Visual Basic 中 DoCmd 物件的對應方法，套用或移除篩選。
使用 DoCmd 物件的 [關閉] 動作或 [關閉] 方法來關閉 [進階篩選/排序] 視窗。
在 巨集 或 Visual Basic (中設定 Filter 或 ServerFilter 屬性或 FilterOn 屬性，不過您可以在 ApplyFilter 事件程序或巨集) 中設定這些屬性。
支援和意見反應
有關於 Office VBA 或這份文件的問題或意見反應嗎？ 如需取得支援服務並提供意見反應的相關指導，請參閱 Office VBA 支援與意見反應。