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 支援與意見反應。