Panel.SetZIndex(UIElement, Int32) Metode

Definisi

Ruang nama:

System.Windows.Controls

Rakitan:

PresentationFramework.dll

Mengatur nilai ZIndex properti terlampir untuk elemen tertentu.

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)

Parameter

element

UIElement

Elemen tempat menerapkan nilai properti.

value

Int32

Urutan pada z-plane tempat elemen ini muncul.

Pengecualian

ArgumentNullException

Elemennya adalah null.

Contoh

Contoh berikut menunjukkan dalam kode cara mengatur nilai ZIndex properti (dengan menggunakan SetZIndex metode ).

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

Keterangan

Semakin besar value dari yang diberikan element, semakin besar kemungkinan element akan muncul di latar depan. Demikian juga, jika memiliki element yang relatif rendah value, element kemungkinan akan muncul di latar belakang. Misalnya, element yang memiliki value 5 akan muncul di atas yang element memiliki value 4, yang pada gilirannya akan muncul di atas yang element memiliki nilai 3, dan sebagainya. Nilai negatif diperbolehkan, dan melanjutkan pola prioritas ini.

Anggota Children koleksi yang memiliki nilai yang sama ZIndex dirender dalam urutan muncul di pohon visual. Anda dapat menentukan posisi indeks anak dengan melakukan iterasi pada anggota Children koleksi.