Compartilhar via


Interface ControlCollection

Representa uma coleção de controles gerenciados em uma planilha do excel em uma solução do Office.

Namespace:  Microsoft.Office.Tools.Excel
Assemblies:   Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)
  Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxe

'Declaração
<GuidAttribute("0B027FC3-018C-4917-AE33-A09E0A30A661")> _
Public Interface ControlCollection _
    Inherits IEnumerable
[GuidAttribute("0B027FC3-018C-4917-AE33-A09E0A30A661")]
public interface ControlCollection : IEnumerable

O tipo ControlCollection expõe os membros a seguir.

Propriedades

  Nome Descrição
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[String] Obtém o controle com o nome especificado.

Superior

Métodos

  Nome Descrição
Método público _VtblGap1_5 Infraestrutura.
Método público AddChart(Range, String) Adiciona um novo controle de Chart a planilha no intervalo especificado.
Método público AddChart(Double, Double, Double, Double, String) Adiciona um novo controle de Chart a planilha no tamanho e o local especificados.
Método público AddControl(Control, Range, String) Adiciona Control especificado a ControlCollection no intervalo especificado.
Método público AddControl(Control, Double, Double, Double, Double, String) Adiciona Control especificado a ControlCollection no local e o tamanho especificados.
Método público AddListObject(ListObject) Adiciona Visual Studio Microsoft.Office.Tools.Excel.ListObject à coleção de controle baseada em nativo especificado Microsoft.Office.Interop.Excel.ListObject.
Método público AddListObject(Range, String) Adiciona um novo controle de ListObject a planilha no intervalo especificado.
Método público AddNamedRange Adiciona um novo controle de NamedRange a planilha no intervalo especificado.
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 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 com o nome especificado da 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, String) Sobrecarregado. Adiciona um novo Button o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddButton(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo Button o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddCheckBox(Range, String) Sobrecarregado. Adiciona um novo CheckBox o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddCheckBox(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo CheckBox o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddCheckedListBox(Range, String) Sobrecarregado. Adiciona um novo CheckedListBox o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddCheckedListBox(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo CheckedListBox o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddComboBox(Range, String) Sobrecarregado. Adiciona um novo ComboBox o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddComboBox(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo ComboBox o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddDataGridView(Range, String) Sobrecarregado. Adiciona um novo DataGridView o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddDataGridView(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo DataGridView o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddDateTimePicker(Range, String) Sobrecarregado. Adiciona um novo DateTimePicker o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddDateTimePicker(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo DateTimePicker o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddDomainUpDown(Range, String) Sobrecarregado. Adiciona um novo DomainUpDown o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddDomainUpDown(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo DomainUpDown o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddHScrollBar(Range, String) Sobrecarregado. Adiciona um novo HScrollBar o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddHScrollBar(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo HScrollBar o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddLabel(Range, String) Sobrecarregado. Adiciona um novo Label o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddLabel(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo Label o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddLinkLabel(Range, String) Sobrecarregado. Adiciona um novo LinkLabel o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddLinkLabel(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo LinkLabel o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddListBox(Range, String) Sobrecarregado. Adiciona um novo ListBox o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddListBox(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo ListBox o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddListView(Range, String) Sobrecarregado. Adiciona um novo ListView o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddListView(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo ListView o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddMaskedTextBox(Range, String) Sobrecarregado. Adiciona um novo MaskedTextBox o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddMaskedTextBox(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo MaskedTextBox controle para o documento no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddMonthCalendar(Range, String) Sobrecarregado. Adiciona um novo MonthCalendar o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddMonthCalendar(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo MonthCalendar o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddNumericUpDown(Range, String) Sobrecarregado. Adiciona um novo NumericUpDown o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddNumericUpDown(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo NumericUpDown o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddPictureBox(Range, String) Sobrecarregado. Adiciona um novo PictureBox o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddPictureBox(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo PictureBox o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddProgressBar(Range, String) Sobrecarregado. Adiciona um novo ProgressBar o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddProgressBar(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo ProgressBar o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddPropertyGrid(Range, String) Sobrecarregado. Adiciona um novo PropertyGrid o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddPropertyGrid(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo PropertyGrid o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddRadioButton(Range, String) Sobrecarregado. Adiciona um novo RadioButton o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddRadioButton(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo RadioButton o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddRichTextBox(Range, String) Sobrecarregado. Adiciona um novo RichTextBox o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddRichTextBox(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo RichTextBox o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddTextBox(Range, String) Sobrecarregado. Adiciona um novo TextBox o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddTextBox(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo TextBox o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddTrackBar(Range, String) Sobrecarregado. Adiciona um novo TrackBar o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddTrackBar(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo TrackBar o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddTreeView(Range, String) Sobrecarregado. Adiciona um novo TreeView o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddTreeView(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo TreeView o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddVScrollBar(Range, String) Sobrecarregado. Adiciona um novo VScrollBar o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddVScrollBar(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo VScrollBar o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)
Método de extensão público AddWebBrowser(Range, String) Sobrecarregado. Adiciona um novo WebBrowser o controle para a planilha no intervalo especificado. (Definido por ControlExtensions.)
Método de extensão público AddWebBrowser(Double, Double, Double, Double, String) Sobrecarregado. Adiciona um novo WebBrowser o controle para a planilha no local e tamanho especificado. (Definido por ControlExtensions.)

Superior

Comentários

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

Você não pode criar uma instância dessa interface em seu código, porque não tem nenhum construtor públicos. Para obter uma instância dessa interface em um projeto de um documento nível, use a propriedade de Controls de uma das classes de Sheetem em seu projeto. Para obter uma instância dessa interface em um projeto de um documento nível, use a propriedade de Controls de um item de host de Worksheet 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 para a planilha.

Use um dos métodos de<control> adicionar. Por exemplo, para adicionar Microsoft.Office.Tools.Excel.ListObject, use o método de AddListObject .

Remova um controle da planilha.

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