Button.BringToFront (Método)

Trae el control Button al frente del orden Z.

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 Function BringToFront As Object

public Object BringToFront()

Valor devuelto

Tipo: System.Object
Este método devuelve una referencia null (Nothing en Visual Basic); si no este método devuelve true.

Comentarios

Este método establece el orden Z del control Button en el último índice de la colección OLEObjects; la numeración del orden Z es opuesta a la numeración del índice en la colección OLEObjects.Cuanto mayor es el índice en la colección OLEObjects, menor es el orden Z del control Button.

Ejemplos

En el ejemplo de código siguiente se utilizan los métodos BringToFront y SendToBack para establecer el orden Z de tres controles Button en una hoja de cálculo.Si se hace clic en el botón situado actualmente en la posición inicial del orden Z, el botón se desplazará hasta la posición final de la colección llamando al método SendToBack.En caso contrario, el botón se desplazará hasta la posición inicial de la colección llamando al método BringToFront.Observe que el orden z de los tres botones inicialmente van de 2 a 4.El control de almacenamiento del motor en tiempo de ejecución en la hoja de cálculo tiene inicialmente la posición en el orden Z de 1.

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

Private Sub ToggleZOrder()
    Dim Button1 As Microsoft.Office.Tools.Excel.Controls.Button = _
        Me.Controls.AddButton(Me.Range("A1", "B2"), "Button1")
    Button1.BackColor = Color.Blue

    Dim Button2 As Microsoft.Office.Tools.Excel.Controls.Button = _
        Me.Controls.AddButton(Me.Range("B2", "C3"), "Button2")
    Button2.BackColor = Color.Red

    Dim Button3 As Microsoft.Office.Tools.Excel.Controls.Button = _
        Me.Controls.AddButton(Me.Range("C3", "D4"), "Button3")
    Button3.BackColor = Color.Green

    AddHandler Button1.Click, AddressOf ZOrderButton_Click
    AddHandler Button2.Click, AddressOf ZOrderButton_Click
    AddHandler Button3.Click, AddressOf ZOrderButton_Click
End Sub

Private Sub ZOrderButton_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)

    If ClickedButton.ZOrder = 4 Then
        ClickedButton.SendToBack()
    Else
        ClickedButton.BringToFront()
    End If
End Sub

private void ToggleZOrder()
{
    Microsoft.Office.Tools.Excel.Controls.Button button1 =
        this.Controls.AddButton(this.Range["A1", "B2"],
        "button1");
    button1.BackColor = Color.Blue;

    Microsoft.Office.Tools.Excel.Controls.Button button2 =
        this.Controls.AddButton(this.Range["B2", "C3"],
        "button2");
    button2.BackColor = Color.Red;

    Microsoft.Office.Tools.Excel.Controls.Button button3 =
        this.Controls.AddButton(this.Range["C3", "D4"],
        "button3");
    button3.BackColor = Color.Green;

    button1.Click += new EventHandler(zOrderButton_Click);
    button2.Click += new EventHandler(zOrderButton_Click);
    button3.Click += new EventHandler(zOrderButton_Click);
}

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

    if (clickedButton.ZOrder == 4)
    {
        clickedButton.SendToBack();
    }
    else
    {
        clickedButton.BringToFront();
    }
}

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)