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 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ê adiciona uma nova forma a uma coleção, ela é adicionada à frente da ordem z por padrã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.