CheckBox-Objekt (Outlook Forms Script)

Zeigt den Auswahlstatus eines Elements an.

HinwBemerkungeneise

Verwenden Sie ein CheckBox-Objekt, um dem Benutzer die Wahl zwischen zwei Werten zu lassen, wie z. B. Ja/Nein, True/False oder Ein/Aus. Wenn der Benutzer ein CheckBox-Objekt auswählt, zeigt es eine spezielle Markierung an (z. B. ein X) und die aktuelle Einstellung lautet Ja, True oder Ein. Wenn der Benutzer das CheckBox-Objekt nicht auswählt, ist es leer und die Einstellung lautet Nein, False oder Aus. Abhängig vom Wert der TripleState-Eigenschaft kann ein CheckBox-Objekt auch einen Null-Wert aufweisen.

Wenn ein CheckBox-Objekt an eine Datenquelle gebunden ist, wird durch Ändern der Einstellung der Wert der Quelle geändert. Ein deaktiviertes CheckBox -Objekt zeigt den aktuellen Wert an, ist jedoch ausgegraut und lässt über die Benutzeroberfläche keine Änderungen an dem Wert zu.

Sie können außerdem Kontrollkästchen innerhalb eines Gruppenfelds verwenden, um eine oder mehrere Gruppen dazugehöriger Elemente auszuwählen. Sie können beispielsweise ein Bestellformular mit einer Liste verfügbarer Elemente erstellen und jedem Element ein CheckBox-Steuerelement voranstellen. Der Benutzer kann ein bestimmtes Element oder Elemente auswählen, indem er das entsprechende CheckBox-Steuerelement aktiviert.

Die Standardeigenschaft eines CheckBox-Objekts ist die Value-Eigenschaft .

Mit dem ListBox-Steuerelement können Sie auch ein Häkchen durch ausgewählte Optionen setzen. Je nach Anwendung kann das ListBox -Steuerelement anstelle einer Gruppe von CheckBox -Steuerelementen verwendet werden.

Ereignisse

Name Beschreibung
Click Tritt auf, wenn der Benutzer in das Steuerelement klickt.

Eigenschaften

Name Beschreibung
Accelerator Dient zum Zurückgeben oder Festlegen der Tastenkombination für ein Steuerelement. Lese-/Schreibzugriff.
Alignment Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Integer, der die Position eines Steuerelements im Verhältnis zum Titel angibt. Lese-/Schreibzugriff.
AutoSize Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Boolean, der angibt, ob die Größe eines Objekts automatisch geändert wird, damit der gesamte Inhalt angezeigt wird. Lese-/Schreibzugriff.
BackColor Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Long, der die Hintergrundfarbe des Objekts angibt. Lese-/Schreibzugriff.
BackStyle Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Integer, der das Hintergrundformat eines Objekts angibt. Lese-/Schreibzugriff.
Caption Gibt einen Wert vom Typ String zurück oder legt ihn fest, der für ein Objekt angezeigt wird, um es zu bestimmen oder zu beschreiben. Lese-/Schreibzugriff.
Enabled Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Boolean, der angibt, ob ein Steuerelement den Fokus erhalten und auf benutzerseitig generierte Ereignisse reagieren kann. Lese-/Schreibzugriff.
ForeColor Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Long, der die Vordergrundfarbe eines Objekts angibt. Lese-/Schreibzugriff.
GroupName Gibt einen Wert vom Typ String zurück, der eine Gruppe sich gegenseitig ausschließender CheckBox -Steuerelemente identifiziert, oder legt diesen Wert fest. Lese-/Schreibzugriff.
Locked Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Boolean, der angibt, ob ein Steuerelement bearbeitet werden kann. Lese-/Schreibzugriff.
MouseIcon Gibt einen Wert vom Typ String zurück, der den vollständigen Pfad eines benutzerdefinierten Symbols angibt, das dem Steuerelement zugewiesen wird. Schreibgeschützt.
MousePointer Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Integer, der den Zeigertyp angibt, der angezeigt wird, wenn der Benutzer die Maus über einem bestimmten Objekt positioniert. Lese-/Schreibzugriff.
Picture Gibt einen Wert vom Typ String zurück, der den vollständigen Pfad einer Bitmap angibt, die in einem Steuerelement angezeigt werden soll. Schreibgeschützt.
PicturePosition Gibt einen Wert vom Typ Integer zurück, der die Position des Bilds relativ zur Beschriftung angibt, oder legt diesen Wert fest. Lese-/Schreibzugriff.
SpecialEffect Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Integer, der die grafische Darstellungsweise eines Objekts angibt. Lese-/Schreibzugriff.
TextAlign Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Integer, der angibt, wie Text in einem Steuerelement ausgerichtet ist. Lese-/Schreibzugriff.
TripleState Gibt einen Boolean-Wert zurück oder legt einen entsprechenden Wert fest, der angibt, ob ein Benutzer auf der Benutzeroberfläche den Null-Zustand für ein CheckBox -Objekt festlegen kann. Lese-/Schreibzugriff.
Wert Gibt einen Variant-Wert zurück, der angibt, ob das Kontrollkästchen aktiviert ist, oder legt diesen Wert fest. Lese-/Schreibzugriff.
WordWrap Dient zum Zurückgeben oder Festlegen eines Werts vom Typ Boolean, der angibt, ob für den Inhalt eines Steuerelements ein automatischer Zeilenumbruch eingefügt wird und ob das Steuerelement vergrößert wird, damit der gesamte Text hineinpasst. Lese-/Schreibzugriff.

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.