Proprietà Button.ZOrder

Ottiene la posizione nell'ordine Z del controllo Button.

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 ReadOnly Property ZOrder As Integer
    Get
public int ZOrder { get; }

Valore proprietà

Tipo: System.Int32
Posizione nell'ordine Z del controllo Button.

Note

L'ordine Z è determinato dall'insieme OLEObjects.

In qualsiasi insieme di oggetti, l'oggetto in background nello z order è insieme(1) mentre l'oggetto in primo piano nello z order è insieme(insieme.Count).

Esempi

Nell'esempio di codice riportato di seguito viene utilizzata la proprietà ZOrder per impostare l'ordine Z di tre controlli Button su un foglio di lavoro. Se si fa clic sul pulsante attualmente in primo piano nell'ordine Z, il pulsante viene spostato dietro l'insieme. In caso contrario, il pulsante verrà spostato davanti all'insieme. 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

Vedere anche

Riferimenti

Button Classe

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