set_window_extents ( : : WindowHandle, Row, Column, Width, Height : )

Modify position and size of a window.

set_window_extents positions the upper left corner of the output window at (Row,Column) and changes the size of the window to Width and Height at the same time.


Attention

If you modify the size of a window an adaptation of the displayed date to the new format is not processed automatically. This has to be done by the program in performing another output of these data.


Parameters

WindowHandle (input_control)
window -> integer
Window identifier.

Row (input_control)
rectangle.origin.y -> integer
Row index of upper left corner in target position.
Default value: 0
Typical range of values: 0 <= Row
Minimum increment: 1
Recommended increment: 1

Column (input_control)
rectangle.origin.x -> integer
Column index of upper left corner in target position.
Default value: 0
Typical range of values: 0 <= Column
Minimum increment: 1
Recommended increment: 1

Width (input_control)
rectangle.extent.x -> integer
Width of the window.
Default value: 512
Typical range of values: 0 <= Width
Minimum increment: 1
Recommended increment: 1

Height (input_control)
rectangle.extent.y -> integer
Height of the window.
Default value: 512
Typical range of values: 0 <= Height
Minimum increment: 1
Recommended increment: 1


Result

If the window is valid and the parameters are correct set_window_extents returns 2 (H_MSG_TRUE). If necessary an exception handling is raised.


Parallelization Information

set_window_extents is reentrant, local, and processed without parallelization.


Possible Predecessors

open_window, open_textwindow


See also

get_window_extents, open_window, open_textwindow


Module

System



Copyright © 1996-2005 MVTec Software GmbH