Worksheet.Controls (Propiedad) (2007 System)

Actualización: Julio de 2008

Obtiene la colección de controles contenida en la hoja de cálculo.

Espacio de nombres:  Microsoft.Office.Tools.Excel
Ensamblado:  Microsoft.Office.Tools.Excel.v9.0 (en Microsoft.Office.Tools.Excel.v9.0.dll)

Sintaxis

<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 propiedad

Tipo: Microsoft.Office.Tools.Excel.ControlCollection

Un objeto ControlCollection que contiene todos los controles de la hoja de cálculo.

Comentarios

Una hoja de cálculo puede actuar como elemento primario de una colección de controles. Cuando se agregan varios controles a una hoja de cálculo, cada uno de los controles es un miembro de la colección ControlCollection de la hoja de cálculo.

Puede agregar controles a ControlCollection o quitarlos utilizando los métodos disponibles en ControlCollection.

Ejemplos

El ejemplo de código siguiente utiliza la propiedad Controls para agregar un objeto Button a la hoja de cálculo actual.

Se trata de una versión para una personalización en el nivel del 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");
}

Se trata de una versión para un complemento en el nivel de la aplicación.

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");
}

Permisos

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

Worksheet (Clase)

Worksheet (Miembros)

Microsoft.Office.Tools.Excel (Espacio de nombres)

Historial de cambios

Fecha	Historial	Motivo
Julio de 2008	Agregada una versión del ejemplo de código para un complemento en el nivel de la aplicación.	Cambio de características de SP1.