Freigeben über


Button.BringToFront-Methode

Verschiebt Button in den Vordergrund der z-Reihenfolge.

Namespace:  Microsoft.Office.Tools.Excel.Controls
Assembly:  Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntax

'Declaration
Public Function BringToFront As Object
public Object BringToFront()

Rückgabewert

Typ: System.Object
Diese Methode gibt einen zurück Nothing NULL-Verweis (in Visual Basic); andernfalls gibt diese Methode true zurück.

Hinweise

Diese Methode legt die z-Reihenfolge von Button auf den letzten Index in der OLEObjects-Auflistung fest. Die Nummerierung der z-Reihenfolge ist der Nummerierung des Index in der OLEObjects-Auflistung entgegengesetzt.Je höher der Index in der OLEObjects-Auflistung, desto niedriger ist die z-Reihenfolge von Button.

Beispiele

Im folgenden Codebeispiel wird mithilfe der BringToFront-Methode und der SendToBack-Methode die z-Reihenfolge von drei Button-Steuerelementen auf einem Arbeitsblatt festgelegt.Wenn auf die Schaltfläche geklickt wird, die sich derzeit im Vordergrund der z-Reihenfolge befindet, wird die Schaltfläche durch einen Aufruf von SendToBack in den Hintergrund der Auflistung verschoben.Andernfalls wird die Schaltfläche durch einen Aufruf von BringToFront in den Vordergrund der Auflistung verschoben.Beachten Sie, dass die z-Reihenfolge der drei Schaltflächen anfänglich zwischen 2 und 4 liegt.Das Laufzeitspeicher-Steuerelement im Arbeitsblatt weist anfänglich die Position in der Z-Reihenfolge von 1 auf.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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

.NET Framework-Sicherheit

Siehe auch

Referenz

Button Klasse

Microsoft.Office.Tools.Excel.Controls-Namespace