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 ZIndex angefügten Eigenschaft für ein bestimmtes 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 -> unitPublic Shared Sub SetZIndex (element As UIElement, value As Integer)Parameter
- element
- UIElement
Das Element, auf das der Eigenschaftswert angewendet werden soll.
- value
- Int32
Die Reihenfolge auf 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 festgelegt wird (mithilfe der SetZIndex Methode).
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 ein value gegebener elementWert ist, desto wahrscheinlicher ist es element , im Vordergrund zu erscheinen. Ebenso wird die element Wahrscheinlichkeit im Hintergrund angezeigt, wenn ein relativ element niedriger valueWert vorhanden ist. Beispielsweise wird ein element Wert value von 5 über einem elementvalue Wert von 4 angezeigt, der wiederum über einem element Wert von 3 angezeigt wird usw. Negative Werte sind zulässig, und sie setzen dieses Rangfolgenmuster fort.
Elemente 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 Elemente der Children Auflistung durchlaufen.
