Panel.SetZIndex(UIElement, Int32) Metodo

Definizione

Spazio dei nomi:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Imposta il valore della proprietà associata ZIndex per un elemento specificato.

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)

Parametri

element

UIElement

Elemento a cui applicare il valore della proprietà.

value

Int32

Ordine nel piano z in cui viene visualizzato questo elemento.

Eccezioni

ArgumentNullException

L'elemento è null.

Esempio

Nell'esempio seguente viene illustrato nel codice come impostare il valore della ZIndex proprietà (usando il SetZIndex metodo ).

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

Commenti

Maggiore è l'oggetto value di un determinato element, più probabile element è che venga visualizzato in primo piano. Analogamente, se un oggetto element ha un valore relativamente basso value, probabilmente element verrà visualizzato in background. Ad esempio, un oggetto element con un value valore pari a 5 verrà visualizzato sopra un element oggetto con un value valore pari a 4, che a sua volta verrà visualizzato sopra un element valore pari a 3 e così via. I valori negativi sono consentiti e continuano questo modello di precedenza.

I membri di una Children raccolta con valori uguali ZIndex vengono visualizzati nell'ordine in cui vengono visualizzati nella struttura ad albero visuale. È possibile determinare la posizione di indice di un elemento figlio eseguendo l'iterazione dei membri della Children raccolta.