Resize
PowerScript function
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
|
1 |
objectname.Resize ( width, height ) |
|
Argument |
Description |
|---|---|
|
objectname |
The name of the object or control you want to |
|
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.
|
1 2 |
objectname.Width = width objectname.Height = height |
The first two statements, although they redraw gb_box1 twice,
achieve the same result as the third statement:
|
1 2 3 |
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:
|
1 |
gb_box1.Resize(100, 150) |
This statement doubles the width and height of the picture control
p_1:
|
1 |
p_1.Resize(p_1.Width*2, p_1.Height*2) |