CheckBox-Objekt (Word)

Repräsentiert ein einzelnes Kontrollkästchen-Formularfeld.

HinwBemerkungeneise

Verwenden Sie FormFields (Index), wobei Index die Indexnummer oder der Textmarkenname ist, der dem Kontrollkästchen zugeordnet ist, um ein einzelnes FormField-Objekt zurückzugeben. Verwenden Sie die CheckBox-Eigenschaft mit dem FormField-Objekt , um ein CheckBox-Objekt zurückzugeben. Im folgenden Beispiel wird das Kontrollkästchen-Formularfeld namens "Check1" im aktiven Dokument ausgewählt.

ActiveDocument.FormFields("Check1").CheckBox.Value = True

Die Indexnummer stellt die Position des Formularfelds in der FormFields-Auflistung dar. Im folgenden Beispiel wird der Typ des ersten Formularfelds überprüft. Wenn es sich um ein Kontrollkästchen handelt, ist das Kontrollkästchen aktiviert.

If ActiveDocument.FormFields(1).Type = wdFieldFormCheckBox Then 
 ActiveDocument.FormFields(1).CheckBox.Value = True 
End If

Im folgenden Beispiel wird geprüft, ob das Objekt ffield gültig ist, bevor die Größe des Kontrollkästchens auf 14 Punkte geändert wird.

Set ffield = ActiveDocument.FormFields(1).CheckBox 
If ffield.Valid = True Then 
 ffield.AutoSize = False 
 ffield.Size = 14 
Else 
 MsgBox "First field is not a check box" 
End If

Verwenden Sie die Add-Methode mit dem FormFields-Objekt , um ein Kontrollkästchen-Formularfeld hinzuzufügen. Im folgenden Beispiel wird am Anfang des aktiven Dokuments ein Kontrollkästchen hinzugefügt, der Name auf "Color" gesetzt und anschließend das Kontrollkästchen aktiviert.

With ActiveDocument.FormFields.Add(Range:=ActiveDocument.Range _ 
 (Start:=0,End:=0), Type:=wdFieldFormCheckBox) 
 .Name = "Color" 
 .CheckBox.Value = True 
End With

Eigenschaften

Siehe auch

Referenz zum Word-Objektmodell

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.