ContentControls.Add-Methode (Word)ContentControls.Add method (Word)

Fügt ein neues Inhaltssteuerelement vom Typ angegeben, in das aktive Dokument und gibt ein ContentControl -Objekt, das das neue Inhaltssteuerelement darstellt.Adds a new content control, of the type specified, into the active document and returns a ContentControl object that represents the new content control.

SyntaxSyntax

expression.expression. Add( _Type_ , _Range_ )

Ausdruck Ein Ausdruck, der ein ContentControls -Objekt zurückgibt.expression An expression that returns a ContentControls object.

ParameterParameters

NameName Erforderlich/OptionalRequired/Optional DatentypData type BeschreibungDescription
TypeType OptionalOptional WdContentControlTypeWdContentControlType Gibt den Typ des Inhaltssteuerelements in das aktive Dokument eingefügt.Specifies the type of content control to insert into the active document. Wenn Length angegeben, fügt Microsoft Word ein Rich-Text-Inhaltssteuerelement an.If omitted, Microsoft Word inserts a rich-text content control.
RangeRange OptionalOptional VariantVariant Gibt an, wo im aktiven Dokument das Inhaltssteuerelement platziert.Specifies where in the active document to place the content control. Wenn Length angegeben, wird von Word setzt das Inhaltssteuerelement an die Position der Einfügemarke oder ersetzt die aktuelle Auswahl.If omitted, Word places the content control at the position of the insertion point or replaces the current selection.

RückgabewertReturn value

ContentControlContentControl

BemerkungenRemarks

Sie können Inhaltssteuerelemente nur in Rich-Text-Inhaltssteuerelemente Baustein Gallery-Inhaltssteuerelemente und Gruppen-Inhaltsteuerelemente schachteln.You can nest content controls only within rich-text content controls, building block gallery content controls, and group content controls. Wenn die Einfügemarke oder die aktuelle Auswahl in einem Inhaltssteuerelement eines anderen Typs ist, löst diese Methode einen Fehler.If the insertion point or current selection is inside a content control of a different type, this method raises an error. In diesem Fall können Sie entweder die Eingabemarke verschieben, oder verwenden den Range-Parameter zum Angeben eines Speicherorts innerhalb des Dokuments.In this case, you can either move the insertion point or use the Range parameter to specify a location within the document.

BeispielExample

Im folgenden Beispiel wird ein neues Dropdownlisten-Inhaltssteuerelement erstellt und der Liste mehrere Elemente hinzugefügt.The following example creates a new drop-down list content control and adds several items to the list.

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 auchSee also

ContentControls-AuflistungContentControls Collection