ZOrder Method
Moves the specified shape in front of or behind other shapes in the collection (that is, changes the shape's position in the z-order).
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