ControlCollection.AddContentControl Method (String, ) (2007 System)
Adds a new ContentControl of the specified type at the current selection in the document.
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 ( _
name As String, _
contentControlType As WdContentControlType _
) As ContentControl
'Usage
Dim instance As ControlCollection
Dim name As String
Dim contentControlType As WdContentControlType
Dim returnValue As ContentControl
returnValue = instance.AddContentControl(name, _
contentControlType)
public ContentControl AddContentControl(
string name,
WdContentControlType contentControlType
)
public:
ContentControl^ AddContentControl(
String^ name,
WdContentControlType contentControlType
)
public function AddContentControl(
name : String,
contentControlType : WdContentControlType
) : ContentControl
Parameters
name
Type: System.StringThe name of the new control.
contentControlType
Type: WdContentControlTypeOne of the Microsoft.Office.Interop.Word.WdContentControlType values that specifies the underlying type of the new content control.
Return Value
Type: Microsoft.Office.Tools.Word.ContentControl
The ContentControl that was added to the document.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | name is nulla null reference (Nothing in Visual Basic) or has zero length. |
| ControlNameAlreadyExistsException | A control with the same name is already in the ControlCollection. |
Remarks
Use this method to add a new ContentControl at the current selection in the document at run time. For more information, see Adding Controls to Office Documents at Run Time.
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.