Panel.SetZIndex(UIElement, Int32) Metoda

Definice

Obor názvů:

System.Windows.Controls

Sestavení:

PresentationFramework.dll

Nastaví hodnotu ZIndex připojené vlastnosti pro daný prvek.

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)

Parametry

element

UIElement

Prvek, na který se má použít hodnota vlastnosti.

value

Int32

Pořadí v rovině z, ve kterém se tento prvek zobrazí.

Výjimky

ArgumentNullException

Element je null.

Příklady

Následující příklad ukazuje v kódu, jak nastavit hodnotu ZIndex vlastnosti (pomocí SetZIndex metody).

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

Poznámky

Čím větší value je daná elementhodnota , tím je pravděpodobnější, že element se objeví v popředí. Podobně pokud má hodnota element relativně nízkou valuehodnotu , element pravděpodobně se zobrazí na pozadí. Například objekt element , který má value hodnotu 5, se zobrazí nad objektem elementvalue , který má hodnotu 4, který se zase zobrazí nad element hodnotou 3 atd. Záporné hodnoty jsou povolené a pokračují v tomto vzoru priority.

Children Členové kolekce, které mají stejné ZIndex hodnoty, se vykreslují v pořadí, ve kterém se zobrazují ve stromu vizuálu. Umístění indexu podřízeného objektu můžete určit iterací členů Children kolekce.