Metodo Button.SendToBack

Articolo
08/11/2011

Porta il controllo Button in background nell'ordine Z.

Spazio dei nomi: Microsoft.Office.Tools.Excel.Controls
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintassi

'Dichiarazione
Public Function SendToBack As Object

public Object SendToBack()

Valore restituito

Tipo: System.Object
In Excel 2010, questo metodo restituisce un riferimento null (Nothing in Visual Basic); in caso contrario questo metodo restituisce true.

Note

Questo metodo imposta l'ordine Z del controllo Button sul primo indice nell'insieme OLEObjects. La numerazione dell'ordine Z è opposta alla numerazione dell'indice nell'insieme OLEObjects. Maggiore è il valore dell'indice nell'insieme OLEObjects, minore sarà l'ordine Z del controllo Button.

Esempi

Nell'esempio di codice riportato di seguito vengono utilizzati i metodi BringToFront e SendToBack per impostare l'ordine Z di tre controlli Button sul foglio di lavoro. Se si fa clic sul pulsante attualmente in primo piano nell'ordine Z, il pulsante viene spostato dietro l'insieme tramite la chiamata al metodo SendToBack. In caso contrario, il pulsante verrà spostato davanti all'insieme chiamando il metodo BringToFront. L'ordine z dei tre pulsanti ha un intervallo iniziale compreso tra 2 e 4. Il Controllo Runtime Storage sul foglio di lavoro dispone inizialmente della posizione nell'ordine Z di 1. Per ulteriori informazioni, vedere Runtime Storage Control Overview.

Questo esempio è valido per una personalizzazione a livello di 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();
    }
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

Button Classe

Spazio dei nomi Microsoft.Office.Tools.Excel.Controls

Condividi tramite