Button.ZOrder-Eigenschaft

Artikel
08/10/2011

Ruft die Position der z-Reihenfolge für Button ab.

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 ReadOnly Property ZOrder As Integer
    Get

public int ZOrder { get; }

Eigenschaftswert

Typ: System.Int32
Die Position der z-Reihenfolge für Button.

Hinweise

Die z-Reihenfolge wird von der OLEObjects-Auflistung bestimmt.

In Objektauflistungen ist das Objekt am hinteren Ende der z-Reihenfolge collection(1). Das Objekt, das sich in der z-Reihenfolge am weitesten vorn befindet, ist collection(collection.Count).

Beispiele

Im folgenden Codebeispiel wird mithilfe der ZOrder-Eigenschaft 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 in den Hintergrund der Auflistung verschoben. Andernfalls wird die Schaltfläche 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