ControlCollection.AddContentControl Método

Definição

Namespace:

Microsoft.Office.Tools.Word

Assemblies:

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

Sobrecargas

AddContentControl(ContentControl, String)	Adiciona um novo ContentControl que se baseia em um controle de conteúdo nativo no documento.
AddContentControl(String, WdContentControlType)	Adiciona um novo ContentControl do tipo especificado na seleção atual no documento.
AddContentControl(Range, String, WdContentControlType)	Adiciona um novo ContentControl do tipo especificado no intervalo especificado no documento.

AddContentControl(ContentControl, String)

Adiciona um novo ContentControl que se baseia em um controle de conteúdo nativo no documento.

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

Parâmetros

contentControl

ContentControl

O Microsoft.Office.Interop.Word.ContentControl que é a base do novo controle.

name

String

O nome do novo controle.

Retornos

ContentControl

O ContentControl adicionado ao documento.

Exceções

ArgumentNullException

contentControl é null.-ou- name é null ou tem comprimento zero.

ControlNameAlreadyExistsException

Um controle com o mesmo nome já está no ControlCollection.

ArgumentException

contentControlnão é uma galeria de blocos de construção (ou seja, o Microsoft.Office.Interop.Word. A propriedade ContentControl.Type de contentControl não tem o valor Microsoft.Office.Interop.Word. WdContentControlType.wdContentControlRichText).

Comentários

Use esse método para adicionar um novo ContentControl baseado em um controle de conteúdo nativo no documento em tempo de execução. Isso é útil quando você cria um ContentControl em tempo de execução e deseja recriar o mesmo controle na próxima vez que o documento for aberto. Para obter mais informações, consulte Adicionando controles a documentos do Office em tempo de execução.

AddContentControl(String, WdContentControlType)

Adiciona um novo ContentControl do tipo especificado na seleção atual no documento.

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

Parâmetros

name

String

O nome do novo controle.

contentControlType

WdContentControlType

Um dos valores de Microsoft.Office.Interop.Word.WdContentControlType que especifica o tipo subjacente do novo controle de conteúdo.

Retornos

ContentControl

O ContentControl adicionado ao documento.

Exceções

ArgumentNullException

name é null ou tem tamanho zero.

ControlNameAlreadyExistsException

Um controle com o mesmo nome já está no ControlCollection.

Comentários

Use esse método para adicionar um novo ContentControl à seleção atual no documento em tempo de execução. Para obter mais informações, consulte Adicionando controles a documentos do Office em tempo de execução.

AddContentControl(Range, String, WdContentControlType)

Adiciona um novo ContentControl do tipo especificado no intervalo especificado no documento.

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

Parâmetros

range

Range

Um Range que fornece os limites para o novo controle.

name

String

O nome do novo controle.

contentControlType

WdContentControlType

Um dos valores de Microsoft.Office.Interop.Word.WdContentControlType que especifica o tipo subjacente do novo controle de conteúdo.

Retornos

ContentControl

O ContentControl adicionado ao documento.

Exceções

ArgumentNullException

name é null ou tem tamanho zero.

ControlNameAlreadyExistsException

Um controle com o mesmo nome já está no ControlCollection.

Comentários

Use esse método para adicionar um novo ContentControl em um intervalo especificado no documento em tempo de execução. Para obter mais informações, consulte Adicionando controles a documentos do Office em tempo de execução.