Panel.SetZIndex(UIElement, Int32) Método

Referência

Definição

Namespace:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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.

Aplica-se a