Resizes an object or control by setting its Width and Height properties and then redraws the object.

Applies to

Any object, except a child DataWindow


objectname.Resize ( width, height )




The name of the object or control you want to resize


The new width in PowerBuilder units


The new height in PowerBuilder units

Return value

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


You cannot use Resize for a child DataWindow.

Resize does not resize a minimized or maximized sheet or window. If the window is minimized or maximized, Resize returns -1.

Equivalent syntax

You can set object's Width and Height properties instead of calling the Resize function. However, the two statements cause PowerBuilder to redraw objectname twice; first with the new width, and then with the new width and height.

objectname.Width = width
objectname.Height = height

The first two statements, although they redraw gb_box1 twice, achieve the same result as the third statement:

gb_box1.Width = 100 // These lines resize 
gb_box1.Height = 150 // gb_box1 to 100 x 150
gb_box1.Resize(100, 150)// So does this line


This statement changes the Width and Height properties of gb_box1 and redraws gb_box1 with the new properties:

gb_box1.Resize(100, 150)

This statement doubles the width and height of the picture control p_1:

p_1.Resize(p_1.Width*2, p_1.Height*2)