OptionButton.GroupName Property (Outlook Forms Script)

Renvoie ou définit une valeur de type String qui identifie un groupe de contrôles OptionButton qui s’excluent mutuellement. Lecture-écriture.

Syntaxe

expression. Groupname

Expression Variable qui représente un objet OptionButton .

Remarques

Utilisez le même GroupName pour tous les boutons du groupe. Le paramètre par défaut est une chaîne vide.

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 fonds transparents, ce qui peut améliorer l'aspect visuel de votre 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 sur le contrôle MultiPage sont un groupe et ceux sur le formulaire en sont un autre. 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.

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.