Share via

ContentControl-Objekt (Word)

  • Artikel

Ein einzelnes Inhaltssteuerelement. Inhaltssteuerelemente sind gebundene und möglicherweise mit Beschriftungen versehene Bereiche in einem Dokument, die als Container für bestimmte Typen von Inhalt dienen. Einzelne Inhaltssteuerelemente können Inhalt wie Daten, Listen oder Absätze mit formatiertem Text enthalten. Das ContentControl-Objekt ist ein Element der ContentControls-Auflistung .

HinwBemerkungeneise

Verwenden Sie die Add-Methode der ContentControls-Auflistung , um ein Inhaltssteuerelement zu erstellen. Use the Type parameter of the Add method to specify the type of content control to create. Im folgenden Beispiel wird ein neues Dropdownlisten-Inhaltssteuerelement erstellt, und diesem werden dann mehrere Elemente hinzugefügt.

Dim objCC As ContentControl 
 
Set objCC = ActiveDocument.ContentControls.Add(Type:=wdContentControlDropdownList) 
 
'List entries 
objCC.DropdownListEntries.Add "Cat" 
objCC.DropdownListEntries.Add "Dog" 
objCC.DropdownListEntries.Add "Horse" 
objCC.DropdownListEntries.Add "Monkey" 
objCC.DropdownListEntries.Add "Snake" 
objCC.DropdownListEntries.Add "Other"

Verwenden Sie die Type-Eigenschaft, um das Inhaltssteuerelement in einen anderen Typ von Inhaltssteuerelement zu ändern. Sie können z. B. ein Datumssteuerelement in ein Textsteuerelement ändern. Allerdings können nicht alle Inhaltssteuerelemente in einen anderen Typ geändert werden, da bei einigen Inhaltssteuerelementen das Ändern des Typs nicht zulässig ist. Außerdem kann es auch an dem Inhalt eines Inhaltssteuerelements liegen, dass der Typ nicht geändert werden kann. Wenn z. B. das Inhaltssteuerelement, in das Sie die Änderung vornehmen möchten, den Typ von Inhalt nicht zulässt, der sich im vorhandenen Inhaltssteuerelement befindet, wird eine Änderung nicht zugelassen, und es wird ein Laufzeitfehler ausgegeben.

Im folgenden Beispiel wird ein Datums-Inhaltssteuerelement eingefügt und der Wert des Steuerelements festgelegt. Dann wird das Steuerelement in ein Text-Inhaltssteuerelement geändert.

Dim objCC As ContentControl 
 
Set objCC = ActiveDocument.ContentControls.Add(wdContentControlDate) 
 
objCC.Range.Text = "January 1, 2007" 
objCC.Type = wdContentControlText

Verwenden Se die SetPlaceholderText-Methode, um den Platzhaltertext aus der Standardzeichenfolge in einen für das Steuerelement passenderen Platzhaltertext zu ändern. Verwenden Sie die Title-Eigenschaft, um den Titeltext für das Steuerelement anzugeben. Dieser wird oberhalb des Steuerelements angezeigt, wenn Sie den Cursor innerhalb des Steuerelements positionieren oder den Mauszeiger über das Steuerelement bewegen.

Je nach Typ des vorliegenden Steuerelements können Sie möglicherweise nicht alle Eigenschaften und Methoden des ContentControl-Objekts verwenden.

Nicht alle Eigenschaften von Inhaltssteuerelementen gelten für all die verschiedenen Typen von Inhaltssteuerelementen. In der folgenden Tabelle wird aufgeführt, welche Eigenschaften für welche Typen von Inhaltssteuerelementen gelten.

Eigenschaft/Methode Gilt für
BuildingBlockCategory property BuildingBlock Gallery content controls (wdContentControlBuildingBlockGallery)
BuildingBlockType property BuildingBlock Gallery content controls (wdContentControlBuildingBlockGallery)
DateDisplayFormat property Date content controls (wdContentControlDate)
DateDisplayLocale property Date content controls (wdContentControlDate)
DateStorageFormat property Date content controls (wdContentControlDate)
DropdownListEntries property Combo box and drop-down list content controls (wdContentControlComboBox and wdContentControlDropdownList)
MultiLine property Plain text content controls (wdContentControlText)
Ungroup method Gruppen-Inhaltsteuerelemente (wdContentControlGroup)

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.