ControlCollection.AddContentControl-Methode (Range, String, WdContentControlType) (2007 System)
Aktualisiert: November 2007
Fügt im angegebenen Bereich im Dokument ein neues ContentControl des angegebenen Typs hinzu.
Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v9.0 (in Microsoft.Office.Tools.Word.v9.0.dll)
Syntax
'Declaration
Public Function AddContentControl ( _
range As Range, _
name As String, _
contentControlType As WdContentControlType _
) As ContentControl
'Usage
Dim instance As ControlCollection
Dim range As Range
Dim name As String
Dim contentControlType As WdContentControlType
Dim returnValue As ContentControl
returnValue = instance.AddContentControl(range, _
name, contentControlType)
public ContentControl AddContentControl(
Range range,
string name,
WdContentControlType contentControlType
)
Parameter
range
Typ: Microsoft.Office.Interop.Word.RangeEin Range, der die Begrenzungen des neuen Steuerelements angibt.
name
Typ: System.StringDer Name des neuen Steuerelements.
contentControlType
Typ: Microsoft.Office.Interop.Word.WdContentControlTypeEiner der Microsoft.Office.Interop.Word.WdContentControlType-Werte, der den zugrunde liegenden Typ des neuen Inhaltssteuerelements angibt.
Rückgabewert
Typ: Microsoft.Office.Tools.Word.ContentControl
Das ContentControl, das dem Dokument hinzugefügt wurde.
Ausnahmen
Ausnahme | Bedingung |
---|---|
ArgumentNullException | name ist nullNULL-Verweis (Nothing in Visual Basic) oder hat die Länge 0 (null). |
ControlNameAlreadyExistsException | Ein Steuerelement mit dem gleichen Namen ist bereits in der ControlCollection vorhanden. |
Hinweise
Verwenden Sie diese Methode, um in einem angegebenen Bereich im Dokument zur Laufzeit ein neues ContentControl hinzuzufügen. Weitere Informationen hierzu finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit.
Berechtigungen
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.