Panel.SetZIndex(UIElement, Int32) Methode

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Legt den Wert der angefügten ZIndex-Eigenschaft für ein angegebenes Element fest.

public:
 static void SetZIndex(System::Windows::UIElement ^ element, int value);

public static void SetZIndex (System.Windows.UIElement element, int value);

static member SetZIndex : System.Windows.UIElement * int -> unit

Public Shared Sub SetZIndex (element As UIElement, value As Integer)

Parameter

element

UIElement

Das Element, auf das der Wert der Eigenschaft angewendet werden soll.

value

Int32

Die Reihenfolge in der Z-Ebene, in der dieses Element angezeigt wird.

Ausnahmen

ArgumentNullException

Das Element ist null.

Beispiele

Im folgenden Beispiel wird im Code veranschaulicht, wie der Wert der ZIndex -Eigenschaft (mithilfe der SetZIndex -Methode) festgelegt wird.

Canvas::SetTop(myRectangle2, 150);
Canvas::SetLeft(myRectangle2, 150);
Canvas::SetZIndex(myRectangle2, 1);
myRectangle2->Fill = Brushes::Yellow;
myRectangle2->Width = 100;
myRectangle2->Height = 100;

Canvas.SetTop(myRectangle2, 150);
Canvas.SetLeft(myRectangle2, 150);
Canvas.SetZIndex(myRectangle2, 1);
myRectangle2.Fill = Brushes.Yellow;
myRectangle2.Width = 100;
myRectangle2.Height = 100;

Canvas.SetTop(myRectangle2, 150)
Canvas.SetLeft(myRectangle2, 150)
Canvas.SetZIndex(myRectangle2, 1)
myRectangle2.Fill = Brushes.Yellow
myRectangle2.Width = 100
myRectangle2.Height = 100

Hinweise

Je größer die value eines gegebenen elementist, desto wahrscheinlicher ist, dass im element Vordergrund angezeigt wird. Ebenso, wenn ein element einen relativ niedrigen valuehat, wird wahrscheinlich element im Hintergrund angezeigt. Beispielsweise wird ein element mit einem value von 5 über einem element angezeigt, das eine value von 4 hat, die wiederum über einem element angezeigt wird, das den Wert 3 aufweist usw. Negative Werte sind zulässig, und sie setzen dieses Rangfolgenmuster fort.

Member einer Children Auflistung mit gleichen ZIndex Werten werden in der Reihenfolge gerendert, in der sie in der visuellen Struktur angezeigt werden. Sie können die Indexposition eines untergeordneten Elements bestimmen, indem Sie die Member der Children Auflistung durchlaufen.