Propriedade Worksheet.Controls

Artigo
05/21/2013

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

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
ReadOnly Property Controls As ControlCollection

ControlCollection Controls { get; }

Valor de propriedade

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

Comentários

Uma planilha em uma solução do Office pode conter controles de formulários do Windows e controles host.Para obter mais informações, consulte Controles em documentos do Office.

Para gerenciar em tempo de execução os controles em uma planilha, use os métodos e propriedades do objeto de ControlCollection retornado pela propriedade de Controls .Para obter mais informações, consulte Adicionar controles a documentos do Office em tempo de execução

Exemplos

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

Este exemplo é para um suplemento ao 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