Метод DoCmd.OpenForm (Access)DoCmd.OpenForm method (Access)

Метод OpenForm выполняет действие OpenForm в Visual Basic.The OpenForm method carries out the OpenForm action in Visual Basic.

СинтаксисSyntax

выражение.OpenForm (FormName, View, FilterName, WhereCondition, DataMode, WindowMode, OpenArgs)expression.OpenForm (FormName, View, FilterName, WhereCondition, DataMode, WindowMode, OpenArgs)

выражение: переменная, представляющая объект DoCmd.expression A variable that represents a DoCmd object.

ПараметрыParameters

ИмяName Обязательный или необязательныйRequired/Optional Тип данныхData type ОписаниеDescription
FormNameFormName ОбязательныйRequired VariantVariant Строковое выражение, являющееся допустимым именем формы в текущей базе данных.A string expression that's the valid name of a form in the current database. При выполнении кода Visual Basic, содержащего метод OpenForm в базе данных библиотеки, Access ищет форму с этим именем сначала в базе данных библиотеки, а затем в текущей базе данных.If you execute Visual Basic code containing the OpenForm method in a library database, Access looks for the form with this name first in the library database, and then in the current database.
ViewView НеобязательныйOptional AcFormViewAcFormView Константа AcFormView, указывающая представление, в котором открывается форма.An AcFormView constant that specifies the view in which the form will open. Значение по умолчанию — acNormal.The default value is acNormal.
FilterNameFilterName НеобязательныйOptional VariantVariant Строковое выражение, являющееся допустимым именем запроса в текущей базе данных.A string expression that's the valid name of a query in the current database.
WhereConditionWhereCondition НеобязательныйOptional VariantVariant Строковое выражение, являющееся допустимым предложением WHERE в SQL без слова WHERE.A string expression that's a valid SQL WHERE clause without the word WHERE.
DataModeDataMode НеобязательныйOptional AcFormOpenDataModeAcFormOpenDataMode Константа AcFormOpenDataMode, указывающая режим ввода данных для формы.An AcFormOpenDataMode constant that specifies the data entry mode for the form. Это относится только к формам, открываемым в режиме формы или режиме таблицы.This applies only to forms opened in Form view or Datasheet view. Значение по умолчанию — acFormPropertySettings.The default value is acFormPropertySettings.
WindowModeWindowMode НеобязательныйOptional AcWindowModeAcWindowMode Константа AcWindowMode, указывающая режим окна, в котором открывается форма.An AcWindowMode constant that specifies the window mode in which the form opens. Значение по умолчанию — acWindowNormal.The default value is acWindowNormal.
OpenArgsOpenArgs НеобязательныйOptional VariantVariant Строковое выражение.A string expression. Это выражение используется для установки свойства OpenArgs формы.This expression is used to set the form's OpenArgs property. Этот параметр можно затем использовать в коде в модуле формы, например в процедуре обработки события Open.This setting can then be used by code in a form module, such as the Open event procedure. Свойство OpenArgs также можно указывать в макросах и выражениях.The OpenArgs property can also be referred to in macros and expressions.

Предположим, что вы открываете ленточную форму со списком клиентов.For example, suppose that the form that you open is a continuous-form list of clients. Если вы хотите, чтобы при открытии формы фокус переместился к записи определенного клиента, вы можете указать имя клиента с аргументом OpenArgs, а затем использовать метод FindRecord для перемещения фокуса на запись клиента с указанным именем.If you want the focus to move to a specific client record when the form opens, you can specify the client name with the OpenArgs argument, and then use the FindRecord method to move the focus to the record for the client with the specified name.

ПримечанияRemarks

С помощью метода OpenForm можно открыть форму в режиме формы, конструктора форм, режиме предварительного просмотра или режиме таблицы.You can use the OpenForm method to open a form in Form view, form Design view, Print Preview, or Datasheet view. Он позволяет выбирать режим ввода данных и режим окна для формы, а также ограничивать количество записей, отображаемых в форме.You can select data entry and window modes for the form and restrict the records that the form displays.

Максимальная длина аргумента WhereCondition — 32 768 символов (в отличие от аргумента действия WhereCondition в окне макроса, максимальная длина которого составляет 256 символов).The maximum length of the WhereCondition argument is 32,768 characters (unlike the WhereCondition action argument in the Macro window, whose maximum length is 256 characters).

ПримерExample

В следующем примере открывается форма Employees (Сотрудники) в режиме формы и отображаются только записи со значением King в поле LastName (Фамилия).The following example opens the Employees form in Form view and displays only records with King in the LastName field. Можно изменять отображаемые записи, а также добавлять новые записи.The displayed records can be edited, and new records can be added.

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

В следующем примере показано, как открыть форму frmMainEmployees в режиме формы и отобразить только записи, которые относятся к отделу, выбранному в поле со спискомcboDept.The following example opens the frmMainEmployees form in Form view and displays only records that apply to the department chosen in the cboDept combo box. Можно изменять отображаемые записи, а также добавлять новые записи.The displayed records can be edited, and new records can be added.

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

В следующем примере показано, как использовать аргумент WhereCondition метода OpenForm, чтобы отфильтровать записи, отображаемые в форме при ее открытии.The following example shows how to use the WhereCondition argument of the OpenForm method to filter the records displayed on a form as it is opened.

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

Поддержка и обратная связьSupport and feedback

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи?Have questions or feedback about Office VBA or this documentation? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.