<< Click to Display Table of Contents >> CheckBox (Objekt) |
Zugriffspfade:
▪Application à Documents à Item à FormFields à Item à CheckBox
▪Application à ActiveDocument à FormFields à Item à CheckBox
1 Beschreibung
Ein CheckBox-Objekt repräsentiert ein einzelnes Formularobjekt vom Typ Checkbox (Kontrollkästchen) und erlaubt es Ihnen, dessen Wert abzufragen und zu ändern.
CheckBox ist ein Tochterobjekt von FormField.
2 Zugriff auf das Objekt
Das CheckBox-Objekt lässt sich ausschließlich über sein übergeordnetes FormField-Objekt ansprechen.
Nur dann, wenn die Eigenschaft CheckBox.Valid den Wert True liefert, handelt es sich wirklich um ein Kontrollkästchen – und nicht etwa ein Textfeld oder eine Auswahlliste.
Ein Beispiel:
' Den Typ des ersten Formularobjekts prüfen.
' Wenn es ein CheckBox-Objekt ist, dessen
' Wert (True oder False) ausgeben.
If tm.ActiveDocument.FormFields(1).CheckBox.Valid Then
MsgBox tm.ActiveDocument.FormFields(1).CheckBox.Value
End If
3 Eigenschaften, Objekte, Sammlungen und Methoden
Eigenschaften:
▪Value (Defaulteigenschaft)
▪Text
▪Valid R/O
Objekte:
▪Application → Application
▪Parent → FormField
Value (Eigenschaft)
Datentyp: Boolean
Liest oder setzt, ob das Kontrollkästchen angekreuzt ist oder nicht (True oder False).
Text (Eigenschaft)
Datentyp: String
Liest oder setzt den Text des Kontrollkästchens.
Valid (Eigenschaft, R/O)
Datentyp: Boolean
Liefert False, wenn das Objekt kein CheckBox-Objekt ist.
Application (Zeiger auf Objekt)
Datentyp: Object
Liefert das Application-Objekt.
Parent (Zeiger auf Objekt)
Datentyp: Object
Liefert das übergeordnete Objekt, also ein Objekt vom Typ FormField.