Panel.SetZIndex(UIElement, Int32) Yöntem

Tanım

Ad Alanı:

System.Windows.Controls

Bütünleştirilmiş Kod:

PresentationFramework.dll

Belirli bir öğe için iliştirilmiş özelliğin ZIndex değerini ayarlar.

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)

Parametreler

element

UIElement

Özellik değerinin uygulanacağı öğe.

value

Int32

Bu öğenin göründüğü z düzlemindeki sıra.

Özel durumlar

ArgumentNullException

öğesidir null.

Örnekler

Aşağıdaki örnekte kodda özelliğin değerinin nasıl ayarlanacağı gösterilmektedir ZIndex (yöntemini kullanarak SetZIndex ).

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

Açıklamalar

Verilen elementdeğerinin value sayısı ne kadar büyükse, ön planda görünme olasılığı element o kadar yüksektir. Benzer şekilde, görece düşük valueelement bir element değere sahipse, büyük olasılıkla arka planda görünür. Örneğin, 5 içeren value bir element değeri 4 olan value bir element değerin üzerinde görünür ve bu da 3 değerine sahip bir element değerinin üzerinde görünür ve bu şekilde devam eder. Negatif değerlere izin verilir ve bu öncelik deseni devam eder.

Eşit ZIndex değerlere sahip bir Children koleksiyonun üyeleri, görsel ağaçta göründükleri sırayla işlenir. Koleksiyonun üyelerini Children yineleyerek bir çocuğun dizin konumunu belirleyebilirsiniz.