Button.SendToBack-Methode

Artikel
08/10/2011

Verschiebt Button in den Hintergrund 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 SendToBack As Object

public Object SendToBack()

Rückgabewert

Typ: System.Object
In Excel 2010 gibt diese Methode einen NULL-Verweis zurück (Nothing in Visual Basic). Andernfalls gibt diese Methode true zurück.

Hinweise

Diese Methode legt die z-Reihenfolge von Button auf den ersten 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. Weitere Informationen finden Sie unter Runtime Storage Control Overview.

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

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

Button Klasse

Microsoft.Office.Tools.Excel.Controls-Namespace

Freigeben über