Propriété GroupName
Crée un groupe de contrôles OptionButton qui s’excluent mutuellement.
Syntaxe
objet . GroupName [= String ]
La syntaxe de la propriété GroupName comprend les éléments suivants :
| Élément | Description |
|---|---|
| object | Obligatoire. Un contrôle OptionButton valide. |
| String | Facultatif. Nom du groupe qui inclut le contrôle OptionButton. Utilisez le même paramètre pour tous les boutons du groupe. Le paramètre par défaut est une chaîne vide. |
Remarques
Pour créer un groupe de contrôles OptionButton qui s’excluent mutuellement, vous pouvez placer les boutons dans un frame sur votre formulaire, ou vous pouvez utiliser la propriété GroupName . GroupName est plus efficace pour les raisons suivantes :
Vous n’avez pas besoin d’inclure un frame pour chaque groupe. Si vous n’utilisez pas de contrôle Frame, vous réduisez le nombre de contrôles sur le formulaire, ce qui, en retour, optimise les performances et réduit la taille du formulaire.
Vous disposez d’une plus grande souplesse de création. Si vous utilisez un contrôle Frame pour créer le groupe, tous les boutons doivent être situés à l’intérieur de ce contrôle Frame. Si vous voulez utiliser plusieurs groupes, vous devez avoir un contrôle Frame pour chaque groupe. En revanche, si vous utilisez la propriété GroupName pour créer le groupe, celui-ci peut inclure des cases d’option situées n’importe où sur le formulaire. Si vous voulez utiliser plusieurs groupes, spécifiez un nom unique pour chaque groupe ; vous pouvez là encore placer les contrôles individuels n’importe où sur le formulaire.
Vous pouvez créer des boutons avec des arrière-plans transparents, ce qui permet d’optimiser l’apparence du formulaire. Le contrôle Frame n’est pas transparent.
Quelle que soit la méthode utilisée pour créer le groupe de boutons, cliquer sur un bouton d’un groupe définit tous les autres boutons du groupe sur False. Tous les boutons d’option avec le même GroupName dans un conteneur sont mutuellement exclusifs. Utilisez le même nom de groupe dans deux conteneurs, mais cela crée deux groupes (un dans chaque conteneur) au lieu d’un groupe qui inclut les deux conteneurs.
Par exemple, supposons que votre formulaire inclut des boutons d’option et un multipage qui inclut également des boutons d’option. Les boutons d’option du multipage sont un groupe, et les boutons du formulaire sont un autre groupe. Les deux groupes ne s’affectent pas mutuellement. Modifier le paramètre d’un bouton sur le contrôle MultiPage n’affecte pas les boutons sur le formulaire.
Voir aussi
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.