Propriedade Worksheet.Controls

Artigo
08/01/2011

Obtém a coleção de controles gerenciados que estão contidos na planilha.

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

Sintaxe

'Declaração
ReadOnly Property Controls As ControlCollection
    Get

ControlCollection Controls { get; }

Valor de propriedade

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

Comentários

Uma planilha em uma solução do Office pode conter controles Windows Forms e controles de host. For more information, see Controles em documentos do Office.

Para gerenciar os controles em uma planilha em tempo de execução, use os métodos e propriedades da ControlCollection objeto retornado pela Controls propriedade. For more information, see Adicionar controles a documentos do Office em tempo de execução

Exemplos

O seguinte exemplo de código usa a Controls propriedade para adicionar um Button para a planilha atual.

Este exemplo é um suplemento em nível de aplicativo.

Private Sub AddButton()

    Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
        Globals.ThisAddIn.Application.ActiveWorksheet("Sheet1")
    Dim vstoWorksheet As Microsoft.Office.Tools.Excel.Worksheet =
        Globals.Factory.GetVstoObject(NativeWorksheet)

    Dim button1 As System.Windows.Forms.Button = _
        vstoWorksheet.Controls.AddButton(50, 50, 150, 50, "button1")
End Sub 'AddButton

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

Segurança do .NET Framework

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ódigo parcialmente confiáveis.

Consulte também

Referência

Worksheet Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via