DoCmd.OpenForm 方法 (Access)

OpenForm 方法在 Visual Basic 中執行 OpenForm 動作。

語法

expression.OpenForm (FormName, View, FilterName, WhereCondition, DataMode, WindowMode, OpenArgs)

expression 代表 DoCmd 物件的變數。

參數

名稱	必要/選用	資料類型	描述
FormName	必要	Variant	字串運算式，代表目前資料庫中某個表單的有效名稱。 如果您在程式庫資料庫中執行包含 OpenForm 方法的 Visual Basic 程式碼，Access 便會先在程式庫資料庫中尋找具有此名稱的表單，然後再到目前的資料庫中尋找。
檢視	選用	AcFormView	AcFormView 常數，指定將開啟表單的檢視。 預設值為 acNormal。
FilterName	選用	Variant	字串運算式，代表目前資料庫中某個查詢的有效名稱。
WhereCondition	選用	Variant	字串運算式，代表不含 WHERE 這個字的有效 SQL WHERE 子句。
DataMode	Optional	AcFormOpenDataMode	AcFormOpenDataMode 常數，指定表單的資料輸入模式。 只適用於 [表單檢視] 或 [資料工作表檢視] 中開啟的表單。 預設值為 acFormPropertySettings。
WindowMode	Optional	AcWindowMode	AcWindowMode 常數，指定開啟表單的視窗模式。 預設值為 acWindowNormal。
OpenArgs	選用	Variant	字串運算式 此運算式用於設定表單的 OpenArgs 屬性。 此設定可以經由程式碼接著用於表單模組，例如 Open 事件程序。 在巨集和運算式中也可以參閱OpenArgs 屬性。 舉例來說，假設您所開啟的表單是客戶的連續表單清單。 如果希望在標單開啟時將焦點移到特定的客戶記錄，您可以使用 OpenArgs 引數指定客戶名稱，接著使用 FindRecord 方法將焦點移至指定名稱的客戶記錄。

註解

使用 OpenForm 方法在 [表單檢視]、[表單設計檢視]、[預覽列印] 或 [資料工作表檢視] 中開啟表單。 您可以選取表單的資料輸入和視窗模式，並限制表單內顯示的記錄。

WhereCondition 引數的最大長度為 32,768 個字元 (與 [巨集] 視窗中的WhereCondition 動作引數不同，其最大長度為 256 個字元)。

範例

下列範例在表單檢視下開啟 Employees 表單，並且只顯示 LastName 欄位值為 King 的記錄。 使用者可以編輯顯示的記錄並新增記錄。

DoCmd.OpenForm "Employees", , ,"LastName = 'King'"

下列範例會在 [表單] 檢視中開啟 frmMainEmployees 表單，並且僅顯示適用於選擇 cboDept 下拉式方塊之部門的記錄。 使用者可以編輯顯示的記錄並新增記錄。

Private Sub cmdFilter_Click()
    DoCmd.OpenForm "frmMainEmployees", , , "DepartmentID=" & cboDept.Value
End Sub

下列範例會顯示如何使用 OpenForm 方法的 WhereCondition 引數，以在表單開啟時篩選上面顯示的記錄。

Private Sub cmdShowOrders_Click()
If Not Me.NewRecord Then
    DoCmd.OpenForm "frmOrder", _
        WhereCondition:="CustomerID=" & Me.txtCustomerID
End If
End Sub

支援和意見反應

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