DoCmd.OpenForm, méthode (Access)DoCmd.OpenForm method (Access)

La méthode OpenForm exécute l’action OpenForm dans Visual Basic.The OpenForm method carries out the OpenForm action in Visual Basic.

SyntaxeSyntax

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

_expression_une variable représentant un objet DoCmd.expression A variable that represents a DoCmd object.

ParamètresParameters

NomName Requis/FacultatifRequired/Optional Type de donnéesData type DescriptionDescription
FormNameFormName RequisRequired VariantVariant Expression de chaîne qui est le nom valide d’un formulaire dans la base de données active.A string expression that's the valid name of a form in the current database. Si vous exécutez du code Visual Basic contenant la méthode OpenForm dans une base de données bibliothèque, Access recherche d’abord le formulaire portant ce nom dans la base de données bibliothèque, puis dans la base de données active.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 FacultatifOptional AcFormViewAcFormView Une constante AcFormView qui spécifie dans quel mode le formulaire va s'ouvrir.An AcFormView constant that specifies the view in which the form will open. La valeur par défaut est acNormal.The default value is acNormal.
FilterNameFilterName FacultatifOptional VariantVariant Expression chaîne qui est le nom valide d'une requête dans la base de données active.A string expression that's the valid name of a query in the current database.
WhereConditionWhereCondition FacultatifOptional VariantVariant Expression chaîne qui est une clause WHERE SQL valide sans le mot WHERE.A string expression that's a valid SQL WHERE clause without the word WHERE.
DataModeDataMode FacultatifOptional AcFormOpenDataModeAcFormOpenDataMode Une constante AcFormOpenDataMode qui spécifie le mode de saisie des données pour le formulaire.An AcFormOpenDataMode constant that specifies the data entry mode for the form. S’applique uniquement aux formulaires ouverts en mode Formulaire ou en mode Feuille de données.This applies only to forms opened in Form view or Datasheet view. La valeur par défaut est acFormPropertySettings.The default value is acFormPropertySettings.
WindowModeWindowMode FacultatifOptional AcWindowModeAcWindowMode Une constante AcWindowMode qui spécifie dans quel mode Fenêtre le formulaire va s'ouvrir.An AcWindowMode constant that specifies the window mode in which the form opens. La valeur par défaut est acWindowNormal.The default value is acWindowNormal.
OpenArgsOpenArgs FacultatifOptional VariantVariant Expression de chaîne.A string expression. Cette expression sert à définir la propriété OpenArgs du formulaire.This expression is used to set the form's OpenArgs property. Ce paramètre peut être utilisé sous forme de code dans un module de formulaire, comme la procédure événementielle Open.This setting can then be used by code in a form module, such as the Open event procedure. La propriété OpenArgs peut également être appelée dans des macros et des expressions.The OpenArgs property can also be referred to in macros and expressions.

Supposons, par exemple, que le formulaire que vous ouvrez soit une liste de clients affichée en continu.For example, suppose that the form that you open is a continuous-form list of clients. Si vous souhaitez que l’enregistrement d’un client particulier devienne actif à l’ouverture du formulaire, vous pouvez définir le nom du client avec l’argument OpenArgs et utiliser la méthode FindRecord pour activer l’enregistrement du client dont le nom vient d’être défini.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.

RemarquesRemarks

Vous pouvez utiliser la méthode OpenForm pour ouvrir un formulaire en mode Formulaire, Création, Aperçu avant impression ou Feuille de données.You can use the OpenForm method to open a form in Form view, form Design view, Print Preview, or Datasheet view. Vous pouvez sélectionner les modes d’affichage et d’entrée de données du formulaire et limiter les enregistrements affichés dans le formulaire.You can select data entry and window modes for the form and restrict the records that the form displays.

L'argument WhereCondition peut comporter jusqu'à 32 768 caractères (contrairement à l'argument de l'action Where Condition dans la fenêtre Macro, dont la longueur ne peut excéder 256 caractères).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).

ExempleExample

Cet exemple ouvre le formulaire Employees en mode Formulaire et affiche uniquement les enregistrements dont le champ LastName contient King.The following example opens the Employees form in Form view and displays only records with King in the LastName field. Les enregistrements affichés peuvent être modifiés, et de nouveaux enregistrements peuvent être ajoutés.The displayed records can be edited, and new records can be added.

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

L’exemple suivant ouvre le formulaire frmMainEmployees en mode Formulaire et affiche uniquement les enregistrements qui s’appliquent au département sélectionné dans la zone de liste modifiable 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. Les enregistrements affichés peuvent être modifiés, et de nouveaux enregistrements peuvent être ajoutés.The displayed records can be edited, and new records can be added.

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

L'exemple suivant montre comment utiliser l'argument WhereCondition de la méthode OpenForm pour filtrer les enregistrements affichés sur un formulaire lors de son ouverture.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

Assistance et commentairesSupport and feedback

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ?Have questions or feedback about Office VBA or this documentation? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.