CheckBox.GroupName Property (Outlook Forms Script)

Renvoie ou définit une valeur de type String qui identifie un groupe de contrôles CheckBox s'excluant mutuellement. Lecture-écriture.

Syntaxe

expression. GroupName

expression Variable qui représente un objet CheckBox .

Remarques

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

Pour créer un groupe de contrôles CheckBox qui s'excluent mutuellement, vous pouvez placer les cases à cocher dans un contrôle Frame de votre formulaire ou 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, toutes les cases à cocher 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 à cocher 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 cases à cocher 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 un groupe de cases à cocher, le fait de cliquer sur une case à cocher du groupe affecte la valeur False à toutes les autres cases à cocher du même groupe. Toutes les cases à cocher ayant la même propriété GroupName à l'intérieur d'un seul conteneur s'excluent mutuellement. 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 comporte des zones de case activée et une page multipage qui inclut également des boutons d’option. Les zones case activée de la multipage sont un groupe et les boutons du formulaire sont un autre groupe. Les deux groupes ne s’affectent pas mutuellement. La modification du paramètre d’une zone de case activée sur la multipage n’affecte pas les zones case activée du 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.