Panel.SetZIndex(UIElement, Int32) Método

Definição

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Define o valor da propriedade anexada ZIndex de um elemento especificado.

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)

Parâmetros

element

UIElement

O elemento no qual o valor da propriedade é aplicado.

value

Int32

A ordem no plano z na qual esse elemento aparece.

Exceções

ArgumentNullException

O elemento é null.

Exemplos

O exemplo a seguir demonstra no código como definir o valor da ZIndex propriedade (usando o SetZIndex método).

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

Comentários

Quanto maior a value de um determinado element, maior a probabilidade de element aparecer em primeiro plano. Da mesma forma, se um element tiver um relativamente baixo value, provavelmente element aparecerá em segundo plano. Por exemplo, um element que tem um value de 5 aparecerá acima de um element que tem um value de 4, que, por sua vez, aparecerá acima de um element que tem um valor de 3 e assim por diante. Valores negativos são permitidos e continuam com esse padrão de precedência.

Os membros de uma Children coleção que têm valores iguais ZIndex são renderizados na ordem em que aparecem na árvore visual. Você pode determinar a posição de índice de um filho iterando os membros da Children coleção.