Worksheet.Controls A propriedade (sistema de 2007)

Obtém a coleção de controles contidos dentro da planilha.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel.v9.0 (em Microsoft.Office.Tools.Excel.v9.0.dll)

Sintaxe

<BrowsableAttribute(False)> _
Public Overridable ReadOnly Property Controls As ControlCollection

Dim instance As Worksheet
Dim value As ControlCollection

value = instance.Controls

[BrowsableAttribute(false)]
public virtual ControlCollection Controls { get; }

Valor de propriedade

Tipo: Microsoft.Office.Tools.Excel.ControlCollection
A ControlCollection que contém todos os controles na planilha.

Comentários

Uma planilha pode atuar sistema autônomo um pai a uma coleção de controles.Quando vários controles são adicionados a uma planilha, cada um dos controles é um membro do ControlCollection da planilha.

Você pode adicionar controles à ControlCollection ou removê-los usando os métodos disponível na ControlCollection classe.

Exemplos

O exemplo de código a seguir usa o Controls propriedade para adicionar um Button a planilha corrente.

Esta versão é para uma personalização em nível de documento.

Private Sub AddButton()
    Dim button1 As Button = _
        Me.Controls.AddButton(50, 50, 150, 50, "button1")
End Sub 'AddButton

private void AddButton()
{
    Button button1 = this.Controls.AddButton(50, 50, 150, 50, "button1");
}

Esta versão é para um suplemento no nível de aplicativo.

Private Sub AddButton()
    Dim vstoWorksheet As Worksheet = _
        CType(Me.Application.ActiveWorkbook.Worksheets(1), Excel.Worksheet) _
        .GetVstoObject()
    Dim button1 As System.Windows.Forms.Button = _
        vstoWorksheet.Controls.AddButton(50, 50, 150, 50, "button1")
End Sub 'AddButton

private void AddButton()
{
    Worksheet vstoWorksheet = ((Excel.Worksheet)
        this.Application.ActiveWorkbook.Worksheets[1]).GetVstoObject();
    System.Windows.Forms.Button button1 = 
        vstoWorksheet.Controls.AddButton(50, 50, 150, 50, "button1");
}

Permissões

• Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de códigos parcialmente Confiável.

Consulte também

Referência

Worksheet Classe

Membros Worksheet

Namespace Microsoft.Office.Tools.Excel

Date	History	Motivo
Julho de 2008	Adicionado a uma versão do código de exemplo para um suplemento em nível de aplicativo.	Alteração de recurso do SP1.