OpenForm, action de macro

S’applique à : Access 2013, Office 2013

Faites appel à l'action OuvrirFormulaire 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.

Setting

L’action OuvrirFormulaire utilise les arguments suivants.

Argument de l’action	Description
Nom du formulaire	Nom du formulaire à ouvrir. La zone Nom du formulaire dans la section Arguments de l'action du volet Générateur de macro présente tous les formulaires dans la base de données actuelle. Il s'agit d'un argument obligatoire. Si vous exécutez une macro contenant l'action OuvrirFormulaire dans une base de données bibliothèque, Microsoft Access recherche d'abord le formulaire portant ce nom dans la base de données bibliothèque, puis dans la base de données actuelle.
Affichage	Affichage dans lequel le formulaire s'ouvre. Cliquez sur Formulaire, Création, Aperçu avant impression, Feuille de données, Tableau croisé dynamique ou Graphique croisé dynamique dans la zone Affichage. La valeur par défaut est Formulaire. REMARQUE : le paramètre d’argument Afficher remplace les paramètres des propriétés DefaultView et ViewsAllowed du formulaire. For example, if a form's ViewsAllowed property is set to Datasheet, you can still use the OpenForm action to open the form in Form view.
Nom du filtre	Filtre qui limite ou trie les enregistrements du formulaire. Vous pouvez entrer le nom d'une requête existante ou d'un filtre enregistré en tant que requête. La requête doit toutefois inclure tous les champs du formulaire que vous ouvrez, ou sa propriété OutputAllFields doit avoir la valeur Oui.
Condition Where	Clause ou expression WHERE SQL valable (sans le mot WHERE) utilisée par Access pour sélectionner des enregistrements dans la table ou requête sous-jacente du formulaire. Si vous sélectionnez un filtre avec l'argument Filter Name, Access applique cette clause WHERE aux résultats du filtre. Pour ouvrir un formulaire et limiter ses enregistrements à ceux spécifiés par la valeur d’un contrôle sur un autre formulaire, utilisez l’expression suivante : [fieldname] = Forms ![formname] ! [controlname on other form] Remplacez fieldname par le nom d’un champ dans la table ou la requête sous-jacente du formulaire que vous souhaitez ouvrir. Remplacez nom_formulaire et nom_contrôle dans l’autre formulaire par le nom de l’autre formulaire et du contrôle dans l’autre formulaire qui contient la valeur avec laquelle vous souhaitez que les enregistrements du premier formulaire correspondent. REMARQUE : La longueur maximale de l’argument Condition Where est de 255 caractères. If you need to enter a more complex SQL WHERE clause longer than this, use the OpenForm method of the DoCmd object in a Visual Basic for Applications (VBA) module instead. You can enter SQL WHERE clause statements of up to 32,768 characters in VBA.
Mode Données	Mode de saisie de données du formulaire. S'applique uniquement aux formulaires ouverts en mode Formulaire ou Feuille de données. Cliquez sur Ajouter (l'utilisateur ne peut pas modifier les enregistrements existants, mais peut en ajouter de nouveaux), Modifier (l'utilisateur peut modifier les enregistrements existants et en ajouter de nouveaux) ou Lecture seule (l'utilisateur peut uniquement consulter les enregistrements). La valeur par défaut est Modifier. Notes Le paramètre d'argument Mode Données remplace les paramètres des propriétés AllowEdits, AllowDeletions, AllowAdditions et DataEntry du formulaire. Par exemple, si la propriété AllowEdits d'un formulaire est définie sur Non, vous pouvez toujours utiliser l'action OuvrirFormulaire pour ouvrir le formulaire en mode Édition. Si vous laissez cet argument vide, Access ouvre le formulaire dans le mode d'entrée de données défini par les propriétés AllowEdits, AllowDeletions, AllowAdditions et DataEntry du formulaire.
Mode Fenêtre	Mode de fenêtre dans laquelle le formulaire s'ouvre. Cliquez sur Normal (le formulaire s'ouvre dans le mode défini par ses propriétés), Masqué (le formulaire est masqué), Icône (le formulaire s'ouvre à la taille réduite sous la forme d'une barre de titre en bas de l'écran) ou Boîte de dialogue (les propriétés Modal et PopUp du formulaire sont définies sur Oui). La valeur par défaut est Normal. REMARQUE : certains paramètres d’argument mode fenêtre ne s’appliquent pas lors de l’utilisation de documents à onglets. Pour passer à des fenêtres superposées : Cliquez sur l’onglet Fichier, puis sur Options. Dans la boîte dialogue Options Access, cliquez sur Base de données active. Dans la section Options de l’application, sous Options de la fenêtre Document, cliquez sur Fenêtres superposées. Cliquez sur OK, puis fermez et rouvrez la base de données.

Remarques

Cette action équivaut à double-cliquer sur un formulaire dans le volet de navigation ou à cliquer avec le bouton droit sur le formulaire dans le volet de navigation et à choisir un affichage.

Un formulaire peut être modal (il doit être fermé ou masqué avant que l'utilisateur puisse effectuer une autre action) ou non modal (l'utilisateur peut accéder à d'autres fenêtres lorsque le formulaire est ouvert). Il peut également être contextuel (un formulaire utilisé pour collecter ou afficher des informations qui reste au-dessus des autres fenêtres Access). Vous définissez les propriétés Modal et PopUp lorsque vous créez le formulaire. Si vous utilisez Normal pour l'argument Mode fenêtre, le formulaire s'ouvre dans le mode spécifié par les paramètres de ces propriétés. Si vous utilisez Boîte de dialogue pour l'argument Mode fenêtre, ces propriétés sont définies sur Oui. Un formulaire ouvert masqué ou sous forme d'icône retourne au mode spécifié par ses paramètres de propriété lorsque vous l'affichez ou le restaurez.

Lorsque vous ouvrez un formulaire avec l'argument Mode fenêtre défini sur Boîte de dialogue, Access suspend la macro jusqu'à ce que le formulaire soit fermé ou masqué. Vous pouvez masquer un formulaire en définissant sa propriété Visible sur Non à l'aide de l'action DéfinirValeur.

Conseil

[!CONSEIL] Vous pouvez sélectionner un formulaire dans le volet de navigation et le faire glisser vers une ligne d'action de macro. Ceci crée automatiquement une action OuvrirFonction qui ouvre le formulaire en mode Formulaire.

Le filtre et la condition WHERE que vous appliquez deviennent les paramètres de la propriété Filter du formulaire.

Exemples

Définissez la valeur d’un contrôle en utilisant une macro

La macro suivante ouvre le formulaire Ajouter des produits à partir d'un bouton dans le formulaire Fournisseurs. Elle présente l'utilisation des actions Écho, FermerFenêtre, OuvrirFormulaire, DéfinirValeur et AtteindreContrôle. L'action DéfinirValeur définit le contrôle N° fournisseur dans le formulaire Produits sur le fournisseur actif dans le formulaire Fournisseurs. L'action AtteindreContrôle déplace ensuite le focus vers le champ N° catégorie, où vous pouvez commencer à entrer des données pour le nouveau produit. Cette macro doit être associée au bouton Ajouter des produits dans le formulaire Fournisseurs.

Action	Arguments : Paramètre	Commentaire
Echo	Écho sur: Non	Arrêter l’actualisation de l’écran pendant l’exécution de la macro.
FermerFenêtre	Type d’objet : FormulaireNom de l’objet : Liste des produits Enregistrer : Non	Fermer le formulaire Liste des produits.
OuvrirFormulaire	Nom du formulaire : Produits Affichage : FormulaireMode de données : AjouterMode Fenêtre :Normal	Ouvrir le formulaire Produits.
DéfinirValeur	Élément: [Forms]![Produits]![N° fournisseur] Expression: N° fournisseur	Définissez le contrôle N° fournisseur sur le fournisseur actuel dans le formulaire Fournisseurs.
AtteindreContrôle	Nom du contrôle: N° catégorie	Accéder au contrôle N° catégorie.

La macro suivante ouvre un formulaire de liste de produits dans le coin inférieur droit du formulaire Fournisseurs, affichant les produits du fournisseur actuel. Elle présente l'utilisation des actions Écho, ZoneMessage, AtteindreContrôle, ArrêtMacro, OuvrirFormulaire et DéplacerEtDimensionnerFenêtre. Elle décrit également l'utilisation d'une expression conditionnelle avec les actions ZoneMessage, AtteindreContrôle, et ArrêtMacro. Cette macro doit être associée au bouton Consulter les produits dans le formulaire Fournisseurs.

Synchroniser des formulaires à l'aide d'une macro

Condition	Action	Arguments : Paramètre	Commentaire
	Echo	Écho sur: Non	Arrêter l'actualisation de l'écran pendant l'exécution de la macro.
IsNull([SupplierID])	MessageBox	Message: Passez à l'enregistrement du fournisseur dont vous voulez voir les produits, puis cliquez à nouveau sur le bouton Consulter les produits. Bip : OuiType : NoneTitle : Sélectionner un fournisseur	S'il n'existe aucun fournisseur actif dans le formulaire Fournisseurs, afficher un message.
...	GoToControl	Nom du contrôle: NomSociété	Déplacer le focus sur le contrôle NomSociété.
...	StopMacro		Arrêter la macro.
	OpenForm	Nom du formulaire : Product List View : DatasheetFilter Name : Where Condition : [SupplierID] = [Forms] ! [Fournisseurs] ! [SupplierID] Mode données : Lecture seuleMode Windows : Normal	Ouvrir le formulaire Liste de produits et afficher les produits du fournisseur actuel.
	MoveAndSizeWindow	Droite: 0.7799" Vers le bas: 1.8"	Positionnez le formulaire Liste de produits dans le coin inférieur droit du formulaire Fournisseurs.