Widget Class: _resizeRegion

Widget Class: _resizeRegion

Resizes an object

Syntax
Details

Syntax

objectName._resizeRegion( );

objectName._resizeRegion( width );

objectName._resizeRegion( width, height );

objectName._resizeRegion( width, height, units );

objectName._resizeRegion( width, height,units,rc );

Details

Specific values can be specified for width and height, or missing values can be used either to leave the size unchanged or to allow interactive resizing.

If a standard missing value is specified (_blank or .) for width or height, the width or height is not changed, respectively. For example, to change the height of obj1 to 3 inches, specify the desired value for height and a missing value for width:

 obj1._resizeRegion(.,3, 'i');

Special missing values can be specified for width and height to allow interactive resizing. See the example. The width and height for the new region are not necessarily the width and height for the object. For example, specifying that the width of a push button is 10 actually causes the push button to have a width of 8 or so, depending on the host. The push button's region has a width of 10.

Width Height Result

5 5 change both the width and height to 5

5 . change the width to 5

. 5 change the height to 5

. . nothing changes

5 .T change the width to 5 and allow the bottom edge to be interactively changed

5 .B change the width to 5 and allow the top edge to be interactively changed

.L 5 change the height to 5 and allow the right edge to be interactively changed

.R 5 change the height to 5 and allow the left edge to be interactively changed

.L .T allow the lower right corner to be interactively changed

.L .B allow the upper right corner to be interactively changed

.R .T allow the lower left corner to be interactively changed

.R .B allow the upper left corner to be interactively changed

Width	Height	Result
5	5	change both the width and height to 5
5	.	change the width to 5
.	5	change the height to 5
.	.	nothing changes
5	.T	change the width to 5 and allow the bottom edge to be interactively changed
5	.B	change the width to 5 and allow the top edge to be interactively changed
.L	5	change the height to 5 and allow the right edge to be interactively changed
.R	5	change the height to 5 and allow the left edge to be interactively changed
.L	.T	allow the lower right corner to be interactively changed
.L	.B	allow the upper right corner to be interactively changed
.R	.T	allow the lower left corner to be interactively changed
.R	.B	allow the upper left corner to be interactively changed

Example

Change the width of obj1 to 2 centimeters and allow the bottom edge (that is, anchor the top edge) to be interactively resized:

 obj1._resizeRegion( 2, .T,'cm');

Allow the lower right corner (that is, anchor the upper left corner) to be resized interactively:

obj1._resizeRegion( .L, .T);

Chapter Contents
Previous
Next
Top of Page