Propriedade Shape.ZOrderPosition (Excel)

Retorna a posição da forma especificada, de acordo com a ordem z. Long somente leitura.

Sintaxe

expressão. ZOrderPosition

expressão Uma variável que representa um objeto Shape.

Comentários

Para definir a posição da forma na ordem z, use o método ZOrder.

A posição de uma forma na ordem z corresponde ao número de índice da forma na coleção Formas . Por exemplo, se existirem quatro formas em myDocument, a expressão myDocument.Shapes(1) devolve a forma na parte de trás da ordem z e a expressão myDocument.Shapes(4) devolve a forma na parte frontal da ordem z.

Sempre que adicionar uma nova forma a uma coleção, esta é adicionada à parte frontal da ordem z por predefinição.

Exemplo

Este exemplo adiciona uma oval a myDocument e a coloca em segundo lugar de trás para frente na ordem z, se houver pelo menos uma forma no documento.

Set myDocument = Worksheets(1) 
With myDocument.Shapes.AddShape(msoShapeOval, 100, 100, 100, 300) 
 While .ZOrderPosition > 2 
 .ZOrder msoSendBackward 
 Wend 
End With

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.