dev_set_window

dev_set_window_extents ( : : Row, Column, Width, Height : )

Change position and size of a graphics window.

dev_set_window_extents changes the position and/or the size of the currently active graphics window.

The parameters Row and Column specify the new position (upper left corner) of the window. If one of both values is negative, the position will remain unchanged. The parameters Width and Height specify the new size of the window. This is the size of the inner part that actually displayes the data. If one of the two values is negative, the size will remain unchanged.

Attention

Never use set_window_extents to change the size and position of an HDevelop graphics window. The operator dev_set_window_extents has to be used instead.

Parameters

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

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

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

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

Example

dev_close_window ()
read_image (For5, 'for5')
get_image_pointer1 (For5, Pointer, Type, Width, Height)
dev_open_window (0, 0, Width, Height, 'black', WindowHandle)
dev_display (For5)
stop ()
dev_set_window_extents (-1,-1,Width/2,Height/2)
dev_display (For5)
stop ()
dev_set_window_extents (200,200,-1,-1)

Result

If the values of the specified parameters are correct dev_set_window_extents returns 2 (H_MSG_TRUE). If necessary an exception handling is raised.

Parallelization Information

dev_set_window_extents is local and processed completely exclusively without parallelization.

Possible Successors

dev_display, dev_set_lut, dev_set_color, dev_set_draw, dev_set_part

See also

set_window_extents

Module

Foundation