Page.SetObjectZOrder

Page.SetObjectZOrder ( 

string ObjectName,

number Position,

string ReferenceObject = "" )

Description

Sets the z-position of an object on the current page.

Parameters

ObjectName

(string) The name of the object.

Position

(number) The z-order position the object should take:

CONSTANT

VALUE

DESCRIPTION

ZORDER_FRONT

0

Move the object to the front of the z-order.

ZORDER_BACK

1

Move the object to the back of the z-order.

ZORDER_FORWARD

2

Move the object forward one position in the z-order.

ZORDER_BACKWARD

3

Move the object backward one position in the z-order.

ZORDER_INSERT_BEFORE

4

Move the object into the z-order position in front of the object specified in ReferenceObject.

ZORDER_INSERT_BEHIND

5

Move the object into the z-order position behind the object specified in ReferenceObject.

ReferenceObject

(string) If Position is set to ZORDER_INSERT_BEFORE or ZORDER_INSERT_BEHIND, this is the object that the object specified in ObjectName will be positioned next to. ReferenceObject is an empty string ("") by default.

Returns

Nothing. You can use Application.GetLastError to determine whether this action failed, and why.

See also:  Related Actions