Udostępnij za pośrednictwem


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 value wartość danego elementelementu , tym bardziej prawdopodobne element jest pojawienie się na pierwszym planie. Podobnie, jeśli obiekt element ma stosunkowo niską wartość value, prawdopodobnie element pojawi się w tle. Na przykład element element o value wartości 5 pojawi się powyżej elementvalue wartości z 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.

Children Elementy członkowskie kolekcji, 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