ZOrderPosition Property

  • Article

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Returns a Long indicating the position of the specified shape or shape range in the z-order. Read-only.

expression.ZOrderPosition

expression   Required. An expression that returns one of the objects in the Applies To list.

Remarks

A shape's position in the z-order corresponds to the shape's index number in the Shapes collection. For example, if there are four shapes on the page, the expression ActiveDocument.Pages(1).Shapes(1) returns the shape at the back of the z-order, and the expression ActiveDocument.Pages(1).Shapes(4) returns the shape at the front of the z-order.

Whenever you add a new shape to a collection, it's added to the front of the z-order by default.

To set the shape's position in the z-order, use the ZOrder method.

Example

This example adds an oval to the active publication, and then places the oval second from the back in the z-order if there is at least one other shape on the slide.

  With ActiveDocument.Pages(1).Shapes _
        .AddShape(Type:=msoShapeOval, _
        Left:=100, Top:=100, Width:=100, Height:=300)
    Do While .ZOrderPosition > 2
        .ZOrder msoSendBackward
    Loop
End With