Compartilhar via

Interface ControlCollection

  • Artigo

Representa uma coleção de controles gerenciados em um documento do Word foi personalizada usando as ferramentas de desenvolvimento do Office em Visual Studio.

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

Sintaxe

'Declaração
<GuidAttribute("E1180F09-B903-4D03-8D30-2845219AEE2C")> _
Public Interface ControlCollection _
    Inherits IEnumerable

[GuidAttribute("E1180F09-B903-4D03-8D30-2845219AEE2C")]
public interface ControlCollection : IEnumerable

O tipo ControlCollection expõe os membros a seguir.

Propriedades

  Nome Descrição
Propriedade pública Capacity Obtém ou define o número de controles que o ControlCollection pode conter.
Propriedade pública Count Obtém o número de controles de ControlCollection.
Propriedade pública Item[Int32] Obtém o controle no índice especificado.
Propriedade pública Item[Object] Obtém o controle especificado.
Propriedade pública Item[String] Obtém o controle com o nome especificado.

Início

Métodos

  Nome Descrição
Método público AddBookmark(Bookmark, String) Adiciona um novo Microsoft.Office.Tools.Word.Bookmark controle para o documento no local existente do Microsoft.Office.Interop.Word.Bookmark especificado.
Método público AddBookmark(Range, String) Adiciona um novo Bookmark o controle para o documento no intervalo especificado.
Método público AddBuildingBlockGalleryContentControl(String) Adiciona um novo BuildingBlockGalleryContentControl na seleção atual no documento.
Método público AddBuildingBlockGalleryContentControl(ContentControl, String) Adiciona um novo BuildingBlockGalleryContentControl à coleção.O novo controle baseia-se em um controle de conteúdo nativo que já está no documento.
Método público AddBuildingBlockGalleryContentControl(Range, String) Adiciona um novo BuildingBlockGalleryContentControl no intervalo especificado no documento.
Método público AddComboBoxContentControl(String) Adiciona um novo ComboBoxContentControl na seleção atual no documento.
Método público AddComboBoxContentControl(ContentControl, String) Adiciona um novo ComboBoxContentControl à coleção.O novo controle baseia-se em um controle de conteúdo nativo que já está no documento.
Método público AddComboBoxContentControl(Range, String) Adiciona um novo ComboBoxContentControl no intervalo especificado no documento.
Método público AddContentControl(ContentControl, String) Adiciona um novo ContentControl que se baseia em um controle de conteúdo nativo no documento.
Método público AddContentControl(String, WdContentControlType) Adiciona um novo ContentControl do tipo especificado na seleção atual no documento.
Método público AddContentControl(Range, String, WdContentControlType) Adiciona um novo ContentControl do tipo especificado no intervalo especificado no documento.
Método público AddControl(Control, Range, Single, Single, String) Adiciona o controle especificado para o ControlCollection no intervalo especificado, com o tamanho especificado.
Método público AddControl(Control, Single, Single, Single, Single, String) Adiciona o controle especificado para o ControlCollection no local especificado, com o tamanho especificado.
Método público AddDatePickerContentControl(String) Adiciona um novo DatePickerContentControl na seleção atual no documento.
Método público AddDatePickerContentControl(ContentControl, String) Adiciona um novo DatePickerContentControl à coleção.O novo controle baseia-se em um controle de conteúdo nativo que já está no documento.
Método público AddDatePickerContentControl(Range, String) Adiciona um novo DatePickerContentControl no intervalo especificado no documento.
Método público AddDropDownListContentControl(String) Adiciona um novo DropDownListContentControl na seleção atual no documento.
Método público AddDropDownListContentControl(ContentControl, String) Adiciona um novo DropDownListContentControl à coleção.O novo controle baseia-se em um controle de conteúdo nativo que já está no documento.
Método público AddDropDownListContentControl(Range, String) Adiciona um novo DropDownListContentControl no intervalo especificado no documento.
Método público AddGroupContentControl(String) Adiciona um novo GroupContentControl na seleção atual no documento.
Método público AddGroupContentControl(ContentControl, String) Adiciona um novo GroupContentControl que se baseia em um controle de conteúdo nativo no documento.
Método público AddGroupContentControl(Range, String) Adiciona um novo GroupContentControl no intervalo especificado no documento.
Método público AddPictureContentControl(String) Adiciona um novo PictureContentControl na seleção atual no documento.
Método público AddPictureContentControl(ContentControl, String) Adiciona um novo PictureContentControl que se baseia em um controle de conteúdo nativo no documento.
Método público AddPictureContentControl(Range, String) Adiciona um novo PictureContentControl no intervalo especificado no documento.
Método público AddPlainTextContentControl(String) Adiciona um novo PlainTextContentControl na seleção atual no documento.
Método público AddPlainTextContentControl(ContentControl, String) Adiciona um novo PlainTextContentControl que se baseia em um controle de conteúdo nativo no documento.
Método público AddPlainTextContentControl(Range, String) Adiciona um novo PlainTextContentControl no intervalo especificado no documento.
Método público AddRichTextContentControl(String) Adiciona um novo RichTextContentControl na seleção atual no documento.
Método público AddRichTextContentControl(ContentControl, String) Adiciona um novo RichTextContentControl que se baseia em um controle de conteúdo nativo no documento.
Método público AddRichTextContentControl(Range, String) Adiciona um novo RichTextContentControl no intervalo especificado no documento.
Método público Contains(Object) Determina se o controle especificado é um membro do ControlCollection instância.
Método público Contains(String) Determina se um controle com o nome especificado é um membro do ControlCollection instância.
Método público GetEnumerator Retorna um enumerador que itera por meio de uma coleção. (Herdado de IEnumerable.)
Método público GetInlineShapeForControl Obtém a base InlineShape para o controle especificado.
Método público GetShapeForControl Obtém a base Shape para o controle especificado.
Método público IndexOf(Object) Procura o controle especificado e retorna o índice baseado em zero da primeira ocorrência na ControlCollection instância.
Método público IndexOf(String) Procura a primeira ocorrência de um controle com o nome especificado na ControlCollection instância.
Método público Remove(Object) Remove o controle especificado a partir de ControlCollection instância.
Método público Remove(String) Remove o controle especificado a partir de ControlCollection instância.
Método público RemoveAt Remove o controle no índice especificado na ControlCollection instância.

Início

Comentários

Use o ControlCollection métodos e propriedades para gerenciar os controles em um documento do Word. For more information, see Adicionar controles a documentos do Office em tempo de execução.

Para obter um ControlCollection o objeto em um projeto de nível de documento, use o Controls propriedade da ThisDocument classe no projeto. Para obter um ControlCollection o objeto em um projeto de nível de aplicativo, use o Controls propriedade de um Document item de host que você criar programaticamente em tempo de execução. For more information, see Estendendo os documentos do Word e pastas de trabalho do Excel em suplementos de nível de aplicativo em tempo de execução.

A tabela a seguir mostra como usar ControlCollection membros para executar algumas tarefas comuns relacionadas a controles em documentos.

Task

Ação

Adicione um controle para o documento.

Use um dos adicionarnomedocontrole métodos. Por exemplo, para adicionar um controle de conteúdo, use o AddContentControl método.

Remova um controle do documento.

Use the Remove method.

Determine se um controle está na coleção.

Passar o controle ou seu nome para o Contains método.

Obter o índice de um controle da coleção.

Passar o controle ou seu nome para o IndexOf método.

Para obter um controle da coleção.

Passar o índice ou nome do controle para o Item propriedade.
ObservaçãoObservação

Esta interface é implementada pelo Visual Studio Tools for Office runtime. Ela não se destina a ser implementada em seu código. Para obter mais informações, consulte Visual Studio Tools for Office visão geral sobre o tempo de execução.

Usage

Esta documentação descreve a versão deste tipo que é usada em projetos do Office destinados ao .NET Framework 4. Em projetos destinados ao .NET Framework 3.5, este tipo poderá ter membros diferentes, e os exemplos de código fornecidos para o tipo talvez não funcionem. Para obter documentação sobre este tipo em projetos destinados ao .NET Framework 3.5, consulte a seguinte seção de referência na documentação do Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Consulte também

Referência

Namespace Microsoft.Office.Tools.Word

Outros recursos

Adicionar controles a documentos do Office em tempo de execução

Métodos auxiliares para controles de Host