ContentControls.Add-Methode (Word)

  • Artikel

Fügt dem aktiven Dokument ein neues Inhaltssteuerelement des angegebenen Typs hinzu und gibt ein ContentControl-Objekt zurück, das das neue Inhaltssteuerelement darstellt.

Syntax

Ausdruck. Hinzufügen (Typ, Bereich)

Ausdruck Ein Ausdruck, der ein ContentControls-Objekt zurückgibt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
Typ Optional WdContentControlType Gibt den Typ des Inhaltssteuerelements an, das in das aktive Dokument eingefügt werden soll. Wenn es weggelassen wird, wird in Microsoft Word ein Rich-Text-Inhaltssteuerelement hinzugefügt.
Range Optional Variant Gibt an, an welcher Stelle im aktiven Dokument das Inhaltssteuerelement platziert werden soll. Wenn es weggelassen wird, wird von Word das Inhaltssteuerelement an die Position der Einfügemarke platziert oder die aktuelle Markierung ersetzt.

Rückgabewert

ContentControl

HinwBemerkungeneise

Sie können Inhaltssteuerelemente nur in Rich-Text-, Bausteinkatalog- und Gruppen-Inhaltssteuerelementen verschachteln. Wenn sich die Einfügemarke oder aktuelle Markierung in einem Inhaltssteuerelement eines anderen Typs befindet, löst diese Methode einen Fehler aus. In diesem Fall können Sie entweder die Einfügemarke verschieben, oder den Range-Parameter verwenden, um den Standort im Dokument anzugeben.

Beispiel

Im folgenden Beispiel wird ein neues Dropdownlisten-Inhaltssteuerelement erstellt und der Liste mehrere Elemente hinzugefügt.

Dim objCC As ContentControl 
 
Set objCC = ActiveDocument.ContentControls.Add(wdContentControlDropdownList) 
objCC.Title = "My Favorite Animal" 
If objCC.ShowingPlaceholderText Then _ 
 objCC.SetPlaceholderText , , "Select your favorite animal " 
 
'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"

Siehe auch

ContentControls-Auflistung

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.