Panel.SetZIndex(UIElement, Int32) Méthode

Définition

Espace de noms:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Définit la valeur de la propriété jointe ZIndex pour un élément donné.

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)

Paramètres

element

UIElement

Élément sur lequel appliquer la valeur de propriété.

value

Int32

Ordre sur le plan z où cet élément apparaît.

Exceptions

ArgumentNullException

L’élément a la valeur null.

Exemples

L’exemple suivant montre comment définir la valeur de la ZIndex propriété (à l’aide de la SetZIndex méthode).

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

Remarques

Plus le value nombre d’éléments donnés elementest élevé, plus il est probable qu’il element apparaisse au premier plan. De même, si une element valeur est relativement faible value, elle element apparaîtra probablement en arrière-plan. Par exemple, une element valeur value de 5 apparaît au-dessus d’une element value valeur de 4, qui apparaît à son tour au-dessus d’une element valeur de 3, et ainsi de suite. Les valeurs négatives sont autorisées et continuent ce modèle de priorité.

Les membres d’une Children collection qui ont des valeurs égales ZIndex sont rendus dans l’ordre dans lequel ils apparaissent dans l’arborescence visuelle. Vous pouvez déterminer la position d’index d’un enfant en itérant les membres de la Children collection.