Move

Description

Moves a control or object to another position relative to its parent window, or for some window objects, relative to the screen.

Applies to

Any object or control

Syntax

objectname.Move ( x, y )

Argument

Description

objectname

The name of the object or control you want to move to a new location

x

The x coordinate of the new location in PowerBuilder units

y

The y coordinate of the new location in PowerBuilder units


Return value

Integer.

Returns 1 if it succeeds and -1 if an error occurs or if objectname is a maximized window. If any argument's value is null, Move returns null.

Usage

The x and y coordinates you specify are the new coordinates of the upper-left corner of the object or control. If the shape of the object or control is not rectangular (such as, a RadioButton or Oval), x and y are the coordinates of the upper-left corner of the box enclosing it. For a line control, x and y are the BeginX and BeginY properties.

When you move controls, drawing objects, and child windows, the coordinates you specify are relative to the upper-left corner of the parent window. When you use Move to position main, pop-up, and response windows, the coordinates you specify are relative to the upper-left corner of the display screen.

Move does not move a maximized sheet or window. If the window is maximized, Move returns -1.

You can specify coordinates outside the frame of the parent window or screen, which effectively makes the object or control invisible.

To draw the image of a Picture control at a particular position, without actually moving the control, use the Draw function.

The Move function changes the X and Y properties of the moved object.

Equivalent syntax

The syntax below directly sets the X and Y properties of an object or control. Although the result is equivalent to using the Move function, it causes PowerBuilder to redraw objectname twice, first at the new location of X and then at the new X and Y location:

objectname.X = x
objectname.Y = y

These statements cause PowerBuilder to redraw gb_box1 twice:

gb_box1.X = 150
gb_box1.Y = 200

This statement has the same result but redraws gb_box1 once:

gb_box1.Move(150,200)

Examples

This statement changes the X and Y properties of gb_box1 to 150 and 200, respectively, and moves gb_box1 to the new location:

gb_box1.Move(150, 200)

This statement moves the picture p_Train2 next to the picture p_Train1:

P_Train2.Move(P_Train1.X + P_Train1.Width, &
    P_Train1.Y)