Compartilhar via


Propriedade ShapeRange.ZOrderPosition (PowerPoint)

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

Sintaxe

expressão. ZOrderPosition

Expressão Uma variável que representa um objeto ShapeRange .

Valor de retorno

Long

Comentários

Shapes(1) retorna a forma ao final da ordem z, e Shapes(Shapes.Count) retorna a forma à frente da ordem z.

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

A posição da forma na ordem z corresponde ao número de índice da forma na coleção Shapes. Por exemplo, se houver quatro formas no slide, a expressão myDocument.Shapes(1) retorna a forma de trás na ordem z, e a expressão myDocument.Shapes(4) retorna a forma à 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 manda a segunda elipse para trás seguindo a ordem z, desde que haja pelo menos uma outra forma no slide.

Set myDocument = ActivePresentation.Slides(1)

With myDocument.Shapes.AddShape(msoShapeOval, 100, 100, 100, 300)

    While .ZOrderPosition > 2

        .ZOrder msoSendBackward

    Wend

End With

Confira também

Objeto ShapeRange

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.