Język

Panel.SetZIndex(UIElement, Int32) Metoda

Definicja

Ustawia wartość dołączonej ZIndex właściwości dla danego elementu.

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

Element, na którym ma być zastosowana wartość właściwości.

value
Int32

Kolejność na płaszczyźnie z, w której pojawia się ten element.

Wyjątki

Element to null.

Przykłady

W poniższym przykładzie pokazano w kodzie, jak ustawić wartość ZIndex właściwości (przy użyciu 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

Uwagi

Im większa wartość value danego elementelementu , tym bardziej prawdopodobne element jest pojawienie się na pierwszym planie. Podobnie, jeśli obiekt element ma stosunkowo niską valuewartość , element prawdopodobnie pojawi się w tle. Na przykład wartość element z wartością value 5 zostanie wyświetlona powyżej elementvalue wartości 4, która z kolei będzie wyświetlana powyżej element wartości 3 itd. Wartości ujemne są dozwolone i kontynuują ten wzorzec pierwszeństwa.

Elementy członkowskie kolekcji Children , które mają równe ZIndex wartości, są renderowane w kolejności, w jakiej są wyświetlane w drzewie wizualizacji. Położenie indeksu elementu podrzędnego można określić, iterując elementy członkowskie Children kolekcji.

Dotyczy