Propiedad Form. OpenArgs (Access)Form.OpenArgs property (Access)

Determina la expresión de cadena especificada en el argumento OpenArgs del método OpenForm que abrió un formulario.Determines the string expression specified by the OpenArgs argument of the OpenForm method that opened a form. Variante de lectura y escritura.Read/write Variant.

SintaxisSyntax

expresión. AbrirArgsexpression.OpenArgs

expresión Variable que representa un objeto Form.expression A variable that represents a Form object.

ComentariosRemarks

Esta propiedad está disponible sólo mediante una macro o mediante Visual Basic con el método OpenForm del objeto DoCmd .This property is available only by using a macro or by using Visual Basic with the OpenForm method of the DoCmd object. El valor de esta propiedad es de solo lectura en todas las vistas.This property setting is read-only in all views.

Para usar la propiedad OpenArgs , abra un formulario mediante el método OpenForm del objeto DoCmd y establezca el argumento AbrirArgs en la expresión de cadena deseada.To use the OpenArgs property, open a form by using the OpenForm method of the DoCmd object and set the OpenArgs argument to the desired string expression. Luego puede usar el valor de la propiedad OpenArgs en el código del formulario, por ejemplo en un procedimiento de evento Open.The OpenArgs property setting can then be used in code for the form, such as in an Open event procedure. También se puede hacer referencia a la propiedad en una macro, por ejemplo una macro Open, o en una expresión, por ejemplo una expresión que establezca la propiedad ControlSource de un control del formulario.You can also refer to the property setting in a macro, such as an Open macro, or an expression, such as an expression that sets the ControlSource property for a control on the form.

Por ejemplo, suponga que el formulario que abre es una lista de clientes de formulario continuo.For example, suppose that the form that you open is a continuous-form list of clients. Si quiere que el foco se mueva a un registro de cliente específico cuando se abra el formulario, puede establecer la propiedad OpenArgs en el nombre del cliente y usar luego la acción FindRecord en una macro Abrir para mover el foco al registro del cliente que tenga el nombre especificado.If you want the focus to move to a specific client record when the form opens, you can set the OpenArgs property to the client's name, and then use the FindRecord action in an Open macro to move the focus to the record for the client with the specified name.

EjemploExample

En el siguiente ejemplo se usa la propiedad AbrirArgs para abrir el formulario empleados en un registro de empleado específico y se muestra cómo el método OpenForm establece la propiedad AbrirArgs .The following example uses the OpenArgs property to open the Employees form to a specific employee record, and demonstrates how the OpenForm method sets the OpenArgs property. Puede ejecutar este procedimiento según corresponda; por ejemplo, cuando se produce el evento AfterUpdate para un cuadro de diálogo personalizado que se utiliza para escribir nueva información sobre un empleado.You can run this procedure as appropriate; for example, when the AfterUpdate event occurs for a custom dialog box used to enter new information about an employee.

Sub OpenToCallahan() 
    DoCmd.OpenForm "Employees", acNormal, , , acReadOnly, _ 
     , "Callahan" 
End Sub 
 
Sub Form_Open(Cancel As Integer) 
    Dim strEmployeeName As String 
    ' If OpenArgs property contains employee name, find 
    ' corresponding employee record and display it on form. For 
    ' example,if the OpenArgs property contains "Callahan", 
    ' move to first "Callahan" record. 
    strEmployeeName = Forms!Employees.OpenArgs 
    If Len(strEmployeeName) > 0 Then 
        DoCmd.GoToControl "LastName" 
        DoCmd.FindRecord strEmployeeName, , True, , True, , True 
    End If 
End Sub

En el ejemplo siguiente se muestra cómo usar la propiedad OpenArgs para evitar que un formulario se abra desde el panel de navegación.The following example shows how to use the OpenArgs property to prevent a form from being opened from the navigation pane.

Private Sub Form_Open(Cancel As Integer)

If Me.OpenArgs() <> "Valid User" Then
    MsgBox "You are not authorized to use this form!", _
        vbExclamation + vbOKOnly, "Invalid Access"
    Cancel = True
End If
End Sub

Soporte técnico y comentariosSupport and feedback

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación?Have questions or feedback about Office VBA or this documentation? 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.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.