Panel.SetZIndex(UIElement, Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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 element
ist, desto wahrscheinlicher ist, dass im element
Vordergrund angezeigt wird. Ebenso, wenn ein element
einen relativ niedrigen value
hat, 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.