Description
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
Syntax
objectname.Resize ( width, height )
|
Argument |
Description |
|---|---|
|
objectname |
The name of the object or control you want to resize |
|
width |
The new width in PowerBuilder units |
|
height |
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.
Usage
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
Examples
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)
