Compartilhar via

Interface ControlCollection

  • Artigo

Representa uma coleção de controles gerenciados em um documento do Word que é personalizado usando as ferramentas de desenvolvimento do Office no Visual Studio.

Namespace:  Microsoft.Office.Tools.Word
Assemblies:   Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)
  Microsoft.Office.Tools.Word.v4.0.Utilities (em Microsoft.Office.Tools.Word.v4.0.Utilities.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 ControlCollection pode conter.
Propriedade pública Count Obtém o número de controles em 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.

Superior

Métodos

  Nome Descrição
Método público _VtblGap1_29 Infraestrutura.
Método público AddBookmark(Bookmark, String) Adiciona um novo controle de Microsoft.Office.Tools.Word.Bookmark o documento no local de Microsoft.Office.Interop.Word.Bookmark existente especificou.
Método público AddBookmark(Range, String) Adiciona um novo controle de Bookmark 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 é baseado 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 é baseado 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 é baseado 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) Adicionar o controle a ControlCollection especificado no intervalo especificado, com o tamanho especificado.
Método público AddControl(Control, Single, Single, Single, Single, String) Adicionar o controle a ControlCollection especificado 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 é baseado 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 é baseado 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 é baseado 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 é baseado 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 é baseado 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 é baseado 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 de instância de ControlCollection .
Método público Contains(String) Determina se um controle com o nome especificado é um membro de instância de ControlCollection .
Método público GetEnumerator Retorna um enumerador que executa iterações através de uma coleção. (Herdado de IEnumerable.)
Método público GetInlineShapeForControl Obtém InlineShape subjacente para o controle especificado.
Método público GetShapeForControl Obtém Shape subjacente para o controle especificado.
Método público IndexOf(Object) Pesquisas para o controle e retorna especificados o índice com base zero da primeira ocorrência na instância de ControlCollection .
Método público IndexOf(String) Pesquisas para a primeira ocorrência de um controle com o nome especificado na instância de ControlCollection .
Método público Remove(Object) Remove o controle específico de instância de ControlCollection .
Método público Remove(String) Remove o controle específico de instância de ControlCollection .
Método público RemoveAt Remove o controle no índice especificado na instância de ControlCollection .

Superior

Métodos de extensão

  Nome Descrição
Método de extensão público AddButton(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de Button o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddButton(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de Button o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddCheckBox(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de CheckBox o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddCheckBox(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de CheckBox o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddCheckedListBox(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de CheckedListBox o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddCheckedListBox(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de CheckedListBox o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddComboBox(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de ComboBox o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddComboBox(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de ComboBox o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddDataGridView(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de DataGridView o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddDataGridView(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de DataGridView o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddDateTimePicker(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de DateTimePicker o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddDateTimePicker(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de DateTimePicker o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddDomainUpDown(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de DomainUpDown o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddDomainUpDown(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de DomainUpDown o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddHScrollBar(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de HScrollBar o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddHScrollBar(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de HScrollBar o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddLabel(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de Label o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddLabel(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de Label o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddLinkLabel(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de LinkLabel o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddLinkLabel(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de LinkLabel o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddListBox(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de ListBox o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddListBox(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de ListBox o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddListView(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de ListView o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddListView(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de ListView o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddMaskedTextBox(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de MaskedTextBox o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddMaskedTextBox(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de MaskedTextBox o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddMonthCalendar(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de MonthCalendar o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddMonthCalendar(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de MonthCalendar o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddNumericUpDown(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de NumericUpDown o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddNumericUpDown(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de NumericUpDown o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddPictureBox(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de PictureBox o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddPictureBox(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de PictureBox o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddProgressBar(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de ProgressBar o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddProgressBar(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de ProgressBar o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddPropertyGrid(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de PropertyGrid o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddPropertyGrid(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de PropertyGrid o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddRadioButton(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de RadioButton o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddRadioButton(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de RadioButton o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddRichTextBox(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de RichTextBox o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddRichTextBox(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de RichTextBox o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddTextBox(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de TextBox o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddTextBox(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de TextBox o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddTrackBar(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de TrackBar o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddTrackBar(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de TrackBar o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddTreeView(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de TreeView o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddTreeView(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de TreeView o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddVScrollBar(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de VScrollBar o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddVScrollBar(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de VScrollBar o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddWebBrowser(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de WebBrowser o documento no tamanho e o local especificados. (Definido por ControlExtensions.)
Método de extensão público AddWebBrowser(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de WebBrowser o documento no tamanho e o local especificados. (Definido por ControlExtensions.)

Superior

Comentários

Use os métodos e propriedades de ControlCollection para gerenciar controles em um documento do Word. Para obter mais informações, consulte Adicionando controles a documentos do Office em tempo de execução.

Para obter um objeto de ControlCollection em um projeto de um documento nível, use a propriedade de Controls da classe de ThisDocument em seu projeto. Para obter um objeto de ControlCollection em um projeto de aplicativo, use a propriedade de Controls de um item de host de Document que você criar programaticamente em tempo de execução. Para obter mais informações, consulte Estendendo documentos do Word e pastas de trabalho do Excel em suplementos no nível do aplicativo em tempo de execução.

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

Tarefa 

Ação

Adicionar um controle ao documento.

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

Remova um controle de documento.

Use o método Remove.

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

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

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

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

Obter um controle da coleção.

Passe o índice ou o nome do controle para a propriedade de Item .

Dica

Essa 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 Visão geral de tempo de execução do Visual Studio Tools for Office.

Uso

Essa documentação descreve a versão desse tipo que é usada apenas nos projetos do Office direcionados ao .NET Framework 4 e ao .NET Framework 4.5. Em projetos direcionados ao .NET Framework 3.5, esse tipo pode ter membros diferentes e os exemplos de código fornecidos para este tipo talvez não funcionem. Para conhecer a documentação sobre esse tipo de projeto direcionado 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

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