Partilhar 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 específico.
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
Método público AddBookmark(Bookmark, String) Adiciona um novo controle de Microsoft.Office.Tools.Word.Bookmark ao documento no local de Microsoft.Office.Interop.Word.Bookmark existente especificou.
Método público AddBookmark(Range, String) Adiciona um novo controle de Bookmark ao documento no intervalo especificado.
Método público AddBuildingBlockGalleryContentControl(String) Adicionar novo BuildingBlockGalleryContentControl na seleção atual no documento.
Método público AddBuildingBlockGalleryContentControl(ContentControl, String) Adicionar novo BuildingBlockGalleryContentControl à coleção.O novo controle é baseado em um controle de conteúdo nativo que já esteja no documento.
Método público AddBuildingBlockGalleryContentControl(Range, String) Adicionar novo BuildingBlockGalleryContentControl no intervalo especificado no documento.
Método público AddComboBoxContentControl(String) Adicionar novo ComboBoxContentControl na seleção atual no documento.
Método público AddComboBoxContentControl(ContentControl, String) Adicionar novo ComboBoxContentControl à coleção.O novo controle é baseado em um controle de conteúdo nativo que já esteja no documento.
Método público AddComboBoxContentControl(Range, String) Adicionar novo ComboBoxContentControl no intervalo especificado no documento.
Método público AddContentControl(ContentControl, String) Adicionar novo ContentControl que é baseado em um controle de conteúdo nativo no documento.
Método público AddContentControl(String, WdContentControlType) Adicionar novo ContentControl do tipo especificado na seleção atual no documento.
Método público AddContentControl(Range, String, WdContentControlType) Adicionar 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) Adicionar novo DatePickerContentControl na seleção atual no documento.
Método público AddDatePickerContentControl(ContentControl, String) Adicionar novo DatePickerContentControl à coleção.O novo controle é baseado em um controle de conteúdo nativo que já esteja no documento.
Método público AddDatePickerContentControl(Range, String) Adicionar novo DatePickerContentControl no intervalo especificado no documento.
Método público AddDropDownListContentControl(String) Adicionar novo DropDownListContentControl na seleção atual no documento.
Método público AddDropDownListContentControl(ContentControl, String) Adicionar novo DropDownListContentControl à coleção.O novo controle é baseado em um controle de conteúdo nativo que já esteja no documento.
Método público AddDropDownListContentControl(Range, String) Adicionar novo DropDownListContentControl no intervalo especificado no documento.
Método público AddGroupContentControl(String) Adicionar novo GroupContentControl na seleção atual no documento.
Método público AddGroupContentControl(ContentControl, String) Adicionar novo GroupContentControl que é baseado em um controle de conteúdo nativo no documento.
Método público AddGroupContentControl(Range, String) Adicionar novo GroupContentControl no intervalo especificado no documento.
Método público AddPictureContentControl(String) Adicionar novo PictureContentControl na seleção atual no documento.
Método público AddPictureContentControl(ContentControl, String) Adicionar novo PictureContentControl que é baseado em um controle de conteúdo nativo no documento.
Método público AddPictureContentControl(Range, String) Adicionar novo PictureContentControl no intervalo especificado no documento.
Método público AddPlainTextContentControl(String) Adicionar novo PlainTextContentControl na seleção atual no documento.
Método público AddPlainTextContentControl(ContentControl, String) Adicionar novo PlainTextContentControl que é baseado em um controle de conteúdo nativo no documento.
Método público AddPlainTextContentControl(Range, String) Adicionar novo PlainTextContentControl no intervalo especificado no documento.
Método público AddRichTextContentControl(String) Adicionar novo RichTextContentControl na seleção atual no documento.
Método público AddRichTextContentControl(ContentControl, String) Adicionar novo RichTextContentControl que é baseado em um controle de conteúdo nativo no documento.
Método público AddRichTextContentControl(Range, String) Adicionar novo RichTextContentControl no intervalo especificado no documento.
Método público Contains(Object) Determina se o controle específico é 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 itera por meio de uma coleção. (Herdado de IEnumerable.)
Método público GetInlineShapeForControl Obtém InlineShape subjacente para o controle específico.
Método público GetShapeForControl Obtém Shape subjacente para o controle específico.
Método público IndexOf(Object) Procura o controle especificados e retorna o índice com base zero da primeira ocorrência na instância de ControlCollection .
Método público IndexOf(String) Procura 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 ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddButton(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de Button ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddCheckBox(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de CheckBox ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddCheckBox(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de CheckBox ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddCheckedListBox(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de CheckedListBox ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddCheckedListBox(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de CheckedListBox ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddComboBox(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de ComboBox ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddComboBox(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de ComboBox ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddDataGridView(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de DataGridView ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddDataGridView(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de DataGridView ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddDateTimePicker(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de DateTimePicker ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddDateTimePicker(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de DateTimePicker ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddDomainUpDown(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de DomainUpDown ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddDomainUpDown(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de DomainUpDown ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddHScrollBar(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de HScrollBar ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddHScrollBar(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de HScrollBar ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddLabel(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de Label ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddLabel(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de Label ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddLinkLabel(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de LinkLabel ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddLinkLabel(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de LinkLabel ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddListBox(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de ListBox ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddListBox(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de ListBox ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddListView(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de ListView ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddListView(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de ListView ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddMaskedTextBox(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de MaskedTextBox ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddMaskedTextBox(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de MaskedTextBox ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddMonthCalendar(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de MonthCalendar ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddMonthCalendar(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de MonthCalendar ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddNumericUpDown(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de NumericUpDown ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddNumericUpDown(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de NumericUpDown ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddPictureBox(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de PictureBox ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddPictureBox(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de PictureBox ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddProgressBar(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de ProgressBar ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddProgressBar(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de ProgressBar ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddPropertyGrid(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de PropertyGrid ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddPropertyGrid(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de PropertyGrid ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddRadioButton(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de RadioButton ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddRadioButton(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de RadioButton ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddRichTextBox(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de RichTextBox ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddRichTextBox(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de RichTextBox ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddTextBox(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de TextBox ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddTextBox(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de TextBox ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddTrackBar(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de TrackBar ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddTrackBar(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de TrackBar ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddTreeView(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de TreeView ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddTreeView(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de TreeView ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddVScrollBar(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de VScrollBar ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddVScrollBar(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de VScrollBar ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddWebBrowser(Range, Single, Single, String) Sobrecarregado. Adiciona um novo controle de WebBrowser ao documento no tamanho e no local especificado. (Definido por ControlExtensions.)
Método de extensão público AddWebBrowser(Single, Single, Single, Single, String) Sobrecarregado. Adiciona um novo controle de WebBrowser ao documento no tamanho e no local especificado. (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 Adicionar 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ê crie programação em tempo de execução.Para obter mais informações, consulte 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 membros de ControlCollection para executar algumas tarefas comuns relacionadas a controles em documentos.

Tarefa 

Ação

Adicione 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 do 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 .
ObservaçãoObservação

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

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 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