Partager via

ToggleButton.GroupName Property (Outlook Forms Script)

  • Article

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

Syntaxe

expression. Groupname

Expression Variable qui représente un objet ToggleButton .

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 ToggleButton qui s'excluent mutuellement, vous pouvez placer les boutons dans un contrôle Frame de votre formulaire ou utiliser la propriété GroupNameGroupName. 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 boutons bascule situés 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 bascule 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 inclut des boutons bascules et un multipage qui inclut également des boutons bascule. Les boutons bascules sur 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.

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.