Button.ShapeRange (Propiedad)

Obtiene un objeto Microsoft.Office.Interop.Excel.ShapeRange que representa el control Button.

Espacio de nombres:  Microsoft.Office.Tools.Excel.Controls
Ensamblado:  Microsoft.Office.Tools.Excel.v4.0.Utilities (en Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxis

'Declaración
Public ReadOnly Property ShapeRange As ShapeRange
    Get

public ShapeRange ShapeRange { get; }

Valor de propiedad

Tipo: Microsoft.Office.Interop.Excel.ShapeRange
Un objeto Microsoft.Office.Interop.Excel.ShapeRange que representa el control Button.

Ejemplos

En el ejemplo de código siguiente se agrega un control Button a la hoja de cálculo actual. El controlador de eventos Click de este botón utiliza la propiedad ShapeRange para obtener un Microsoft.Office.Interop.Excel.ShapeRange para el botón y, a continuación, aumenta el ancho de este Microsoft.Office.Interop.Excel.ShapeRange en 10 puntos. Si bien el controlador de eventos sólo ajusta el ancho del botón, el alto también cambia automáticamente para que se mantengan las proporciones originales del control.

Se trata de un ejemplo para una personalización en el nivel del documento.

Private Sub UseShapeRange()
    Dim GrowingButton As Microsoft.Office.Tools.Excel.Controls.Button = _
        Me.Controls.AddButton(Me.Range("B2", "C3"), "GrowingButton")
    GrowingButton.Text = "Click to grow button"
    AddHandler GrowingButton.Click, AddressOf GrowingButton_Click
End Sub

Private Sub GrowingButton_Click(ByVal sender As Object, ByVal e As EventArgs)
    Dim ClickedButton As Microsoft.Office.Tools.Excel.Controls.Button = _
        CType(sender, Microsoft.Office.Tools.Excel.Controls.Button)

    ClickedButton.ShapeRange.Width += 10
End Sub

private void UseShapeRange()
{
    Microsoft.Office.Tools.Excel.Controls.Button growingButton =
        this.Controls.AddButton(this.Range["B2", "C3"],
        "growingButton");
    growingButton.Text = "Click to grow button";
    growingButton.Click +=
        new EventHandler(growingButton_Click);
}

void growingButton_Click(object sender, EventArgs e)
{
    Microsoft.Office.Tools.Excel.Controls.Button clickedButton =
        (Microsoft.Office.Tools.Excel.Controls.Button)sender;

    clickedButton.ShapeRange.Width += 10;
}

Seguridad de .NET Framework

• 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

Button Clase

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