Método Button.SendToBack
Envia Button verso da ordem z.
Namespace: Microsoft.Office.Tools.Excel.Controls
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Sintaxe
'Declaração
Public Function SendToBack As Object
public Object SendToBack()
Valor de retorno
Tipo: System.Object
Esse método retorna uma referência nula (no Visual Basic)Nothing ; se não esse método retorna true.
Comentários
Este método define a ordem z de Button para o primeiro índice na coleção de OLEObjects ; a numeração da ordem z é o oposto de numeração do índice na coleção de OLEObjects .Quanto maior o índice na coleção de OLEObjects , menor a ordem z de Button.
Exemplos
O exemplo de código usa os métodos de BringToFront e de SendToBack para definir a ordem z de três controles de Button em uma planilha.Se o botão na frente da ordem z é clicado atualmente, o botão é movido verso de coleção chamando SendToBack.Caso contrário, o botão é movido na frente de coleção chamando BringToFront.Observe que a ordem z dos três botões inicialmente varia de 2 a 4.O controle de armazenamento de tempo de execução na planilha tem inicialmente a posição da ordem z de 1.
Este exemplo é para uma personalização da nível.
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();
}
}
Segurança do .NET Framework
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.