Panel.SetZIndex(UIElement, Int32) Método

Referencia

Definición

Espacio de nombres:: System.Windows.Controls

Ensamblado:: PresentationFramework.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Establece el valor de la propiedad adjunta ZIndex de un elemento concreto.

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)

Parámetros

element: UIElement

Elemento en el que se va a aplicar el valor de la propiedad.

value: Int32

Orden en el plano z en que aparece este elemento.

Excepciones

ArgumentNullException

El elemento es null.

Ejemplos

En el ejemplo siguiente se muestra en el código cómo establecer el valor de la ZIndex propiedad (mediante el SetZIndex método ).

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

Comentarios

Cuanto mayor sea el value valor de un determinado element, más probable element es que aparezca en primer plano. Del mismo modo, si tiene element un valor relativamente bajo value, element es probable que aparezca en segundo plano. Por ejemplo, un element que tiene un value de 5 aparecerá encima de un element que tiene un value de 4, que a su vez aparecerá encima de un element que tiene un valor de 3, etc. Se permiten valores negativos y continúan con este patrón de precedencia.

Los miembros de una Children colección que tienen valores iguales ZIndex se representan en el orden en que aparecen en el árbol visual. Puede determinar la posición de índice de un elemento secundario mediante la iteración de los miembros de la Children colección.

Se aplica a