DR MOVE

4D - Documentation   Français   English   German   4D Draw 2004, Command Theme List   4D Draw 2004, Command Alphabetical List   Back   Previous   Next

version 6.0


DR MOVE (area; scope; moveH; moveV; mode)

ParameterTypeDescription
areaLongint4D Draw area
scopeLongint-1=All
0=Selected
>0=0bject ID
moveHNumberHorizontal movement
moveVNumberVertical movement
modeInteger0=Absolute
1=Relative

Description

The command DR MOVE repositions the objects in area described by scope.

If scope equals -1, DR MOVE repositions all objects in the document.

If scope equals 0, DR MOVE repositions the selected objects.

If scope is greater than 0, it must be equal to a specific object's ID; DR MOVE repositions that object. If the object does not exist, DR Error returns error number 2.

The objects described by scope are moved according to the moveH, moveV, and mode parameters. You can specify moveH and moveV as offsets from the current origin (absolute) or as offsets from the object's current position (relative).

If mode equals 0, moveH and moveV are absolute coordinates.

If mode equals 1, moveH and moveV are relative coordinates.

Positive values indicate a direction down or right. Negative values indicate a direction up or left. Both moveH and moveV are expressed in base units. Use the DR Scale to base function to convert from scale units to base units.

Example

The following examples are the object methods for four different buttons named bLeft, bRight, bUp, and bDown. Each button moves the selected objects one base unit in the given direction.

      `bLeft
   DR MOVE(Area;0;-1;0;1)
      `bRight
   DR MOVE(Area;0;1;0;1)
      `bUp
   DR MOVE(Area;0;0;-1;1)
      `bDown
   DR MOVE(Area;0;0;1;1)

See Also

DR Get ID, DR SCALE, DR SIZE.


4D - Documentation   Français   English   German   4D Draw 2004, Command Theme List   4D Draw 2004, Command Alphabetical List   Back   Previous   Next