Button.SendToBack-Methode
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
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 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.
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.