DoCmd.OpenForm, méthode (Access)

La méthode OpenForm exécute l’action OpenForm dans Visual Basic.

Syntaxe

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

expressionune variable représentant un objet DoCmd.

Paramètres

Nom Requis/Facultatif Type de données Description
FormName Requis Variant Expression de chaîne qui est le nom valide d’un formulaire dans la base de données active. 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.
View Facultatif AcFormView Une constante AcFormView qui spécifie dans quel mode le formulaire va s'ouvrir. La valeur par défaut est acNormal.
FilterName Facultatif Variant Expression chaîne qui est le nom valide d'une requête dans la base de données active.
WhereCondition Facultatif Variant Expression chaîne qui est une clause WHERE SQL valide sans le mot WHERE.
DataMode Facultatif AcFormOpenDataMode Une constante AcFormOpenDataMode qui spécifie le mode de saisie des données pour le formulaire. S’applique uniquement aux formulaires ouverts en mode Formulaire ou en mode Feuille de données. La valeur par défaut est acFormPropertySettings.
WindowMode Facultatif AcWindowMode Une constante AcWindowMode qui spécifie dans quel mode Fenêtre le formulaire va s'ouvrir. La valeur par défaut est acWindowNormal.
OpenArgs Facultatif Variant Expression de chaîne. Cette expression sert à définir la propriété OpenArgs du formulaire. Ce paramètre peut être utilisé sous forme de code dans un module de formulaire, comme la procédure événementielle Open. La propriété OpenArgs peut également être appelée dans des macros et des expressions.

Supposons, par exemple, que le formulaire que vous ouvrez soit une liste de clients affichée en continu. 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.

Remarques

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. 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.

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).

Exemple

Cet exemple ouvre le formulaire Employees en mode Formulaire et affiche uniquement les enregistrements dont le champ LastName contient King. Les enregistrements affichés peuvent être modifiés, et de nouveaux enregistrements peuvent être ajoutés.

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. Les enregistrements affichés peuvent être modifiés, et de nouveaux enregistrements peuvent être ajoutés.

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.

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

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette 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.