Método DoCmd.OpenForm (Access)
El método OpenForm lleva a cabo la acción OpenForm en Visual Basic.
Sintaxis
expresión.OpenForm (FormName, View, FilterName, WhereCondition, DataMode, WindowMode, OpenArgs)
expresión Variable que representa un objeto DoCmd.
Parámetros
| Nombre | Obligatorio/opcional | Tipo de datos | Descripción |
|---|---|---|---|
| FormName | Necesario | Variant | Expresión de cadena que es el nombre válido de un formulario de la base de datos actual. Si ejecuta código de Visual Basic que contenga el método OpenForm en una base de datos de biblioteca, Access busca el formulario con este nombre primero en la base de datos de biblioteca y luego en la base de datos actual. |
| Vista | Opcional | AcFormView | Constante AcFormView que especifica la vista en la que se abrirá el formulario. El valor predeterminado es acNormal. |
| NombreDeFiltro | Opcional | Variant | Expresión de cadena que es el nombre válido de una consulta de la base de datos activa. |
| CondiciónWhere | Opcional | Variant | Expresión de cadena que es una cláusula WHERE de SQL válida sin la palabra WHERE. |
| ModoDeDatos | Optional | AcFormOpenDataMode | Constante AcFormOpenDataMode que especifica el modo de entrada de datos del formulario. Esto se aplica únicamente a los formularios que se abren en la vista Formulario u Hoja de datos. El valor predeterminado es acFormPropertySettings. |
| ModoDeVentana | Opcional | AcWindowMode | Constante AcWindowMode que especifica el modo de la ventana en el que se abre el formulario. El valor predeterminado es acWindowNormal. |
| OpenArgs | Opcional | Variant | Expresión de cadena. Esta expresión se usa para establecer la propiedad OpenArgs del formulario. Después, este valor se puede usar en el código de un módulo de formulario, por ejemplo, el procedimiento de evento Open. También se puede hacer referencia a la propiedad OpenArgs en macros y expresiones. Por ejemplo, suponga que el formulario que abre es una lista de clientes de formulario continuo. Si quiere que el foco se mueva a un registro de cliente específico al abrir el formulario, puede especificar el nombre del cliente con el argumento OpenArgs y, después, usar el método FindRecord para mover el foco al registro del cliente con el nombre especificado. |
Comentarios
Puede usar el método OpenForm para abrir un formulario en la vista Formulario, vista Diseño, Vista previa de impresión o vista Hoja de datos. Puede seleccionar los modos de entrada de datos y ventana para el formulario y restringir los registros que muestra el formulario.
La longitud máxima del argumento WhereCondition es de 32 768 caracteres (a diferencia del argumento de acción WhereCondition en la ventana Macro, cuya longitud máxima es de 256 caracteres).
Ejemplo
El siguiente ejemplo abre el formulario Employees en la vista Formulario y muestra solo los registros que contienen King en el campo LastName. Los registros que se muestran se pueden editar y se pueden agregar registros nuevos.
DoCmd.OpenForm "Employees", , ,"LastName = 'King'"
En el ejemplo siguiente, se abre el formulario frmMainEmployees en la vista Formulario y se muestran solo los registros que se aplican al departamento elegido en el cuadro combinado cboDept. Los registros que se muestran se pueden editar y se pueden agregar registros nuevos.
Private Sub cmdFilter_Click()
DoCmd.OpenForm "frmMainEmployees", , , "DepartmentID=" & cboDept.Value
End Sub
En el ejemplo siguiente, se ve cómo usar el argumento WhereCondition del método OpenForm para filtrar los registros que se muestran en un formulario cuando se abre.
Private Sub cmdShowOrders_Click()
If Not Me.NewRecord Then
DoCmd.OpenForm "frmOrder", _
WhereCondition:="CustomerID=" & Me.txtCustomerID
End If
End Sub
Soporte técnico y comentarios
¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.