Compartilhar via


Panel.SetZIndex(UIElement, Int32) Método

Definição

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

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.

Aplica-se a