Shape.ZOrder Method (Word)

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).

Syntax

expression .ZOrder(ZOrderCmd)

expression An expression that returns a Shape object.

Parameters

Name

Required/Optional

Data Type

Description

ZOrderCmd

Required

MsoZOrderCmd

Specifies where to move the specified shape relative to the other shapes.

Return Value

Nothing

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

See Also

Concepts

Shape Object

Shape Object Members