ControlCollection::AddRichTextContentControl Method (Range^, String^)

Adds a new RichTextContentControl at the specified range in the document.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Syntax

C++

RichTextContentControl^ AddRichTextContentControl(
	Range^ range,
	String^ name
)

Parameters

range: Type: Microsoft.Office.Interop.Word::Range^
A Range that provides the bounds for the new control.

name: Type: System::String^
The name of the new control.

Return Value

Type: Microsoft.Office.Tools.Word::RichTextContentControl^

The RichTextContentControl that was added to the document.

Exceptions

Exception	Condition
ArgumentNullException	name is null or has zero length.
ControlNameAlreadyExistsException	A control with the same name is already in the ControlCollection.

Remarks

Use this method to add a new RichTextContentControl at a specified range in the document at run time. For more information, see Adding Controls to Office Documents at Run Time.

Examples

The following code example adds a new RichTextContentControl to the beginning of the document.

This version is for a document-level customization. To use this code, paste it into the ThisDocument class in your project, and call the AddRichTextControlAtRange method from the ThisDocument_Startup method.

C++

No code example is currently available or this language may not be supported.

This version is for an application-level add-in that targets the .NET Framework 4 or the .NET Framework 4.5. To use this code, paste it into the ThisAddIn class in your project, and call the AddRichTextControlAtRange method from the ThisAddIn_Startup method.

C++