Freigeben über


ToggleButton.GroupName Property (Outlook Forms Script)

Dient zum Zurückgeben oder Festlegen eines Werts vom Typ String, der eine Gruppe sich gegenseitig ausschließender ToggleButton -Steuerelemente angibt. Lese-/Schreibzugriff.

Syntax

Ausdruck. GroupName

Ausdruck Eine Variable, die ein ToggleButton-Objekt darstellt.

Hinweise

Verwenden Sie dieselbe GroupName-Eigenschaft für alle Schaltflächen in der Gruppe. Die Standardeinstellung ist eine leere Zeichenfolge.

Um eine Gruppe von sich gegenseitig ausschließenden ToggleButton-Steuerelementen zu erstellen, können Sie die Schaltflächen in einem Frame-Steuerelement in Ihrem Formular platzieren, oder Sie können die GroupName-Eigenschaft verwenden. Die GroupName-Eigenschaft ist aus folgenden Gründen effizienter:

  • Sie müssen nicht für jede Gruppe einen Frame einschließen. Wenn Sie keine Rahmen-Steuerelemente ( Frame) verwenden, reduzieren Sie die Anzahl der Steuerelemente auf dem Formular, verbessern auf diese Weise das Leistungsverhalten des Formulars und verringern dessen Größe.

  • Sie gewinnen eine höhere Entwurfsflexibilität. Wenn Sie zum Erstellen der Gruppe ein Frame-Steuerelement verwenden, müssen sich alle Schaltflächen innerhalb des Frame-Steuerelements befinden. Wenn Sie mehr als eine Gruppe erstellen möchten, benötigen Sie für jede Gruppe ein Frame-Steuerelement. Wenn Sie jedoch die GroupName-Eigenschaft zum Erstellen der Gruppe verwenden, kann die Gruppe Umschaltflächen an beliebiger Position auf dem Formular enthalten. Möchten Sie mehr als eine Gruppe erstellen, geben Sie für jede Gruppe einen eindeutigen Namen an; Sie können die einzelnen Steuerelemente weiterhin an beliebiger Stelle auf dem Formular platzieren.

  • Sie können Schaltflächen mit transparenten Hintergründen erstellen, wodurch sich möglicherweise das Erscheinungsbild Ihres Formulars verbessern lässt. Ein Frame-Steuerelement ist kein transparentes Steuerelement.

Ungeachtet mit welcher Methode Sie Schaltflächengruppen erstellen, werden, wenn Sie auf eine Schaltfläche in einer Gruppe klicken, alle anderen Schaltflächen der Gruppe auf False festgelegt. Alle Umschaltflächen mit der gleichen GroupName-Eigenschaft innerhalb eines einzelnen Containers schließen sich gegenseitig aus. Verwenden Sie denselben Gruppennamen in zwei Containern, aber dadurch werden zwei Gruppen (eine in jedem Container) anstelle einer Gruppe erstellt, die beide Container enthält.

Nehmen wir beispielsweise an, das Formular enthält einige Umschaltflächen sowie ein MultiPage -Objekt, in dem sich ebenfalls Umschaltflächen befinden. Die Umschaltflächen im MultiPage-Objekt bilden eine Gruppe und die Schaltflächen auf dem Formular eine andere. Die beiden Gruppen wirken sich nicht gegenseitig aus. Wenn Sie die Einstellung einer Schaltfläche im MultiPage-Objekt ändern, hat dies keinen Einfluss auf die Schaltflächen auf dem Formular.

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.