Edit

Shape.ZOrder method (Word)

  • Article

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

Shape Object

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.