Panel.SetZIndex(UIElement, Int32) Метод

Определение

Пространство имен:

System.Windows.Controls

Сборка:

PresentationFramework.dll

Задает значение присоединенного свойства ZIndex для указанного объекта.

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)

Параметры

element

UIElement

Элемент, для которого следует применить значение свойства.

value

Int32

Порядок в плоскости z, в котором отображается этот элемент.

Исключения

ArgumentNullException

Элемент имеет значение null.

Примеры

В следующем примере кода показано, как задать значение ZIndex свойства (с помощью 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

Комментарии

Чем больше value заданного elementобъекта , тем выше вероятность element появления на переднем плане. Аналогичным образом, если element имеет относительно низкий уровень value, скорее element всего, будет отображаться в фоновом режиме. Например, объект , element имеющий value значение 5, будет отображаться над element , который имеет value значение 4, который, в свою очередь, будет отображаться над element , имеющий значение 3, и т. д. Отрицательные значения разрешены, и они продолжают этот шаблон приоритета.

Children Элементы коллекции с равными ZIndex значениями отображаются в том порядке, в котором они отображаются в визуальном дереве. Вы можете определить положение индекса дочернего элемента, выполнив итерацию элементов Children коллекции.