ControlCollection.AddContentControl Метод

Определение

Пространство имен:

Microsoft.Office.Tools.Word

Сборки:

Microsoft.Office.Tools.Word.dll, Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Перегрузки

AddContentControl(ContentControl, String)	Добавляет новый объект ContentControl, основанный на собственном элементе управления содержимым, в документ.
AddContentControl(String, WdContentControlType)	Добавляет в выделенный в настоящий момент фрагмент документа новый элемент управления ContentControl указанного типа.
AddContentControl(Range, String, WdContentControlType)	Добавляет в заданный диапазон документа новый элемент управления ContentControl указанного типа.

AddContentControl(ContentControl, String)

Добавляет новый объект ContentControl, основанный на собственном элементе управления содержимым, в документ.

public:
 Microsoft::Office::Tools::Word::ContentControl ^ AddContentControl(Microsoft::Office::Interop::Word::ContentControl ^ contentControl, System::String ^ name);

public Microsoft.Office.Tools.Word.ContentControl AddContentControl (Microsoft.Office.Interop.Word.ContentControl contentControl, string name);

abstract member AddContentControl : Microsoft.Office.Interop.Word.ContentControl * string -> Microsoft.Office.Tools.Word.ContentControl

Public Function AddContentControl (contentControl As ContentControl, name As String) As ContentControl

Параметры

contentControl

ContentControl

Объект Microsoft.Office.Interop.Word.ContentControl, который является основой для нового элемента управления.

name

String

Имя нового элемента управления.

Возвращаемое значение

ContentControl

Объект ContentControl, добавленный в документ.

Исключения

ArgumentNullException

contentControl имеет nullзначение .-or- name is null или имеет нулевую длину.

ControlNameAlreadyExistsException

Элемент управления с таким именем уже содержится в ControlCollection.

ArgumentException

contentControlне является коллекцией стандартных блоков (то есть Microsoft.Office.Interop.Word. Свойство contentControl ContentControl.Type не имеет значения Microsoft.Office.Interop.Word. WdContentControlType.wdContentControlRichText).

Комментарии

Используйте этот метод для добавления нового ContentControl объекта, основанного на собственном элементе управления содержимым, в документе во время выполнения. Это полезно при создании ContentControl во время выполнения и при следующем открытии документа необходимо повторно создать тот же элемент управления. Для получения дополнительной информации см. Adding Controls to Office Documents at Run Time.

AddContentControl(String, WdContentControlType)

Добавляет в выделенный в настоящий момент фрагмент документа новый элемент управления ContentControl указанного типа.

public:
 Microsoft::Office::Tools::Word::ContentControl ^ AddContentControl(System::String ^ name, Microsoft::Office::Interop::Word::WdContentControlType contentControlType);

public Microsoft.Office.Tools.Word.ContentControl AddContentControl (string name, Microsoft.Office.Interop.Word.WdContentControlType contentControlType);

abstract member AddContentControl : string * Microsoft.Office.Interop.Word.WdContentControlType -> Microsoft.Office.Tools.Word.ContentControl

Public Function AddContentControl (name As String, contentControlType As WdContentControlType) As ContentControl

Параметры

name

String

Имя нового элемента управления.

contentControlType

WdContentControlType

Одно из значений Microsoft.Office.Interop.Word.WdContentControlType, указывающих основной тип нового элемента управления содержимым.

Возвращаемое значение

ContentControl

Объект ContentControl, добавленный в документ.

Исключения

ArgumentNullException

name имеет значение null или нулевую длину.

ControlNameAlreadyExistsException

Элемент управления с таким именем уже содержится в ControlCollection.

Комментарии

Используйте этот метод, чтобы добавить новый ContentControl объект в текущем выделенном фрагменте документа во время выполнения. Для получения дополнительной информации см. Adding Controls to Office Documents at Run Time.

AddContentControl(Range, String, WdContentControlType)

Добавляет в заданный диапазон документа новый элемент управления ContentControl указанного типа.

public:
 Microsoft::Office::Tools::Word::ContentControl ^ AddContentControl(Microsoft::Office::Interop::Word::Range ^ range, System::String ^ name, Microsoft::Office::Interop::Word::WdContentControlType contentControlType);

public Microsoft.Office.Tools.Word.ContentControl AddContentControl (Microsoft.Office.Interop.Word.Range range, string name, Microsoft.Office.Interop.Word.WdContentControlType contentControlType);

abstract member AddContentControl : Microsoft.Office.Interop.Word.Range * string * Microsoft.Office.Interop.Word.WdContentControlType -> Microsoft.Office.Tools.Word.ContentControl

Public Function AddContentControl (range As Range, name As String, contentControlType As WdContentControlType) As ContentControl

Параметры

range

Range

Объект Range, предоставляющий границы для нового элемента управления.

name

String

Имя нового элемента управления.

contentControlType

WdContentControlType

Одно из значений Microsoft.Office.Interop.Word.WdContentControlType, указывающих основной тип нового элемента управления содержимым.

Возвращаемое значение

ContentControl

Объект ContentControl, добавленный в документ.

Исключения

ArgumentNullException

name имеет значение null или нулевую длину.

ControlNameAlreadyExistsException

Элемент управления с таким именем уже содержится в ControlCollection.

Комментарии

Используйте этот метод для добавления нового ContentControl объекта в указанном диапазоне в документе во время выполнения. Для получения дополнительной информации см. Adding Controls to Office Documents at Run Time.