ZOrder Method

Microsoft Word Visual Basic

expression.ZOrder(ZOrderCmd)

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

ZOrderCmd   Required MsoZOrderCmd. Specifies where to move the specified shape relative to the other shapes.

MsoZOrderCmd can be one of these MsoZOrderCmd constants.
msoBringForward
msoBringInFrontOfText
msoBringToFront
msoSendBackward
msoSendBehindText
msoSendToBack

Remarks

Use the ZOrderPosition property to determine a shape's current position in the z-order.

Example

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

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