Compartilhar via


Método ControlCollection.AddContentControl (ContentControl, String)

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

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

Sintaxe

'Declaração
Function AddContentControl ( _
    contentControl As ContentControl, _
    name As String _
) As ContentControl
ContentControl AddContentControl(
    ContentControl contentControl,
    string name
)

Parâmetros

Valor de retorno

Tipo: Microsoft.Office.Tools.Word.ContentControl
O ContentControl que foi adicionado ao documento.

Exceções

Exceção Condição
ArgumentNullException

contentControl is nulluma referência nula (Nothing no Visual Basic).

- ou -

nameé nulluma referência nula (Nothing no Visual Basic) ou tem comprimento zero.

ControlNameAlreadyExistsException

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

ArgumentException

contentControlnão é uma Galeria de bloco de construção (isto é, o Microsoft.Office.Interop.Word.ContentControl.Type propriedade de contentControl não tem o valor Microsoft.Office.Interop.Word.WdContentControlType.wdContentControlRichText).

Comentários

Use esse método para adicionar um novo ContentControl que se baseia em um controle de conteúdo nativo no documento no tempo de execução. Isso é útil quando você cria um ContentControl em tempo de execução, e você quiser recriar o mesmo controle na próxima vez em que o documento for aberto. For more information, see Adicionar controles a documentos do Office em tempo de execução.

Segurança do .NET Framework

Consulte também

Referência

ControlCollection Interface

Sobrecargas AddContentControl

Namespace Microsoft.Office.Tools.Word