Moving an object to a new positionΒΆ

move

Move an object to a new position (pixel)

charmove

Move an object to a new position (character)


SYNTAX

move object_id to x, y

charmove object_id to column, row

Move the object, placing its top left corner at the position specified.

The move command uses pixel positioning from Sculptor V5 onwards.

The charmove command, introduced with Sculptor V5, uses character positioning, the only mode available in earlier versions.

The two commands are otherwise identical.

object_id

The identifier of the object to be moved. The object_id may be a window_id, button_id, graphic_id, listbox_id, table_id, text_id or box_id.

x, y

The x and y co-ordinates to which the object is to be moved (pixel positioning). Both x and y may be any expression that evaluates to an integer value.

column, row

The column and row to which the object is to be moved (character positioning). Both column and row may be any expression that evaluates to an integer value.

The position of a window is counted from the top left-hand corner of its parent window. Moving a window also moves any child windows it possesses. The parent of a window may be allocated as a window clause. If this clause is absent the default parent is the desktop. The parent of the task window wintask is always the desktop.

The co-ordinates of a window control are counted from the top left-hand corner of the window in which it appears. No part of a control can appear outside its window. If it is moved to a position that overlaps the window edge, that part which is outside the window becomes invisible.


NOTES

  • The move command does not affect the co-ordinates used if the object is re-created. In order to change these at run time, the constructions:

    object_id->xcreate = int_expression

    object_id->ycreate = int_expression

    are used. Now the command create object_id causes the object to be re-created at the position specified.

  • The move cursor command repositions the window cursor in pixels.


EXAMPLE

move Window3 to 52,30

RELATED TOPICS

Pixel and character positioning

Windows

Initial position of a window or object

Current position of a window or object