Interface ControlCollection

Artigo
08/01/2011

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

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.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
	Count	Obtém o número de controles de ControlCollection.
	Item[Int32]	Obtém o controle no índice especificado.
	Item[String]	Obtém o controle com o nome especificado.

Início

Métodos

	Nome	Descrição
	AddChart(Range, String)	Adiciona um novo Chart o controle para a planilha no intervalo especificado.
	AddChart(Double, Double, Double, Double, String)	Adiciona um novo Chart o controle para a planilha no tamanho especificado e o local.
	AddControl(Control, Range, String)	Adiciona especificado Control para o ControlCollection no intervalo especificado.
	AddControl(Control, Double, Double, Double, Double, String)	Adiciona especificado Control para o ControlCollection no local e tamanho especificado.
	AddListObject(ListObject)	Adiciona um Visual Studio Microsoft.Office.Tools.Excel.ListObject para a coleção de controle com base em nativa especificada Microsoft.Office.Interop.Excel.ListObject.
	AddListObject(Range, String)	Adiciona um novo ListObject o controle para a planilha no intervalo especificado.
	AddNamedRange	Adiciona um novo NamedRange o controle para a planilha no intervalo especificado.
	Contains(Object)	Determina se o controle especificado é um membro do ControlCollection instância.
	Contains(String)	Determina se um controle com o nome especificado é um membro do ControlCollection instância.
	GetEnumerator	Retorna um enumerador que itera por meio de uma coleção. (Herdado de IEnumerable.)
	IndexOf(Object)	Procura o controle especificado e retorna o índice baseado em zero da primeira ocorrência na ControlCollection instância.
	IndexOf(String)	Procura a primeira ocorrência de um controle com o nome especificado na ControlCollection instância.
	Remove(Object)	Remove o controle especificado a partir de ControlCollection instância.
	Remove(String)	Remove o controle com o nome especificado a partir de ControlCollection instância.
	RemoveAt	Remove o controle no índice especificado na ControlCollection instância.

Início

Comentários

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

É possível criar uma instância desta interface no seu código, porque não tem nenhum construtor público. Para obter uma instância desta interface em um projeto de nível de documento, use o Controls a propriedade de um a Sheetn classes em seu projeto. Para obter uma instância desta interface em um projeto de nível de documento, use o Controls propriedade de um Worksheet 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 a planilha.	Use um dos adicionar<control> métodos. Por exemplo, para adicionar um Microsoft.Office.Tools.Excel.ListObject, use o AddListObject método.
Remova um controle da planilha.	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çã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.Excel

Compartilhar via