Propriedade Shape.ZOrderPosition (Word)

Retorna um Long que representa a posição da forma especificada na ordem z. Somente leitura.

Sintaxe

expressão. ZOrderPosition

Expressão Uma expressão que retorna um objeto Shape .

Comentários

Shapes(1) retorna a forma de trás na ordem z, e Shapes(Shapes.Count) retorna a forma à frente da ordem z. Essa propriedade é somente leitura. 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 Shapes. Por exemplo, se houver quatro formas no myDocument, a expressão myDocument.Shapes(1) retornará a forma na parte de trás da ordem z e a expressão myDocument.Shapes(4) retornará a forma na frente da ordem z.

Sempre que você adicionar uma nova forma a uma coleção, por padrão ela será adicionada à frente da ordem z.

Exemplo

Este exemplo adiciona uma elipse a myDocument e coloca a elipse como segunda de trás na ordem z se já houver pelo menos uma outra forma no documento.

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

Confira também

Objeto Shape

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.