Partager via

CheckBox.GroupName Property (Outlook Forms Script)

  • Article

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 cases à cocher et une page multipage qui inclut également des boutons d’option. Les cases à cocher sur le MultiPage sont un groupe et les boutons du formulaire sont un autre groupe. Les deux groupes ne s’affectent pas mutuellement. La modification de la valeur d’une case à cocher sur multipage n’affecte pas les cases à cocher 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.