dev_set_window_extentsdev_set_window_extentsDevSetWindowExtentsDevSetWindowExtents (Operator)

Name

dev_set_window_extentsdev_set_window_extentsDevSetWindowExtentsDevSetWindowExtents — Change position and size of the active graphics window.

Signature

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

Description

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

The parameters RowRowRowRowrow and ColumnColumnColumnColumncolumn specify the new position (upper left corner) of the window. Depending on the window mode of HDevelop, the coordinates (0,0) refer to the upper left corner of the window area in the main HDevelop window in MDI mode, and the upper left corner of the screen in SDI mode, respectively. Negative coordinates of the position are ignored, i.e., in this direction the window will not be moved.

The parameters WidthWidthWidthWidthwidth and HeightHeightHeightHeightheight specify the new size of the window. This is the size of the inner part that actually displays the iconic objects. If one of the two values is negative, this dimension will remain unchanged.

Attention

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

Using the code export feature of HDevelop, the code that is generated for this operator may have a different behavior than the related HALCON operator. For a detailed description of the code export of HDevelop graphics operators into the different programming languages see in the “HDevelop User's Guide” the chapter Code Export -> General Aspects of Code Generation -> Graphics Windows.

Parameters

RowRowRowRowrow (input_control) rectangle.origin.y → (integer)

Row index of upper left corner.

Default value: 0

Typical range of values: 0 ≤ Row Row Row Row row

Minimum increment: 1

Recommended increment: 1

Restriction: Row >= 0 || Row == -1

ColumnColumnColumnColumncolumn (input_control) rectangle.origin.x → (integer)

Column index of upper left corner.

Default value: 0

Typical range of values: 0 ≤ Column Column Column Column column

Minimum increment: 1

Recommended increment: 1

Restriction: Column >= 0 || Column == -1

WidthWidthWidthWidthwidth (input_control) rectangle.extent.x → (integer)

Width of the window.

Default value: 256

Typical range of values: 0 ≤ Width Width Width Width width

Minimum increment: 1

Recommended increment: 1

Restriction: Width > 0 || Width == -1

HeightHeightHeightHeightheight (input_control) rectangle.extent.y → (integer)

Height of the window.

Default value: 256

Typical range of values: 0 ≤ Height Height Height Height height

Minimum increment: 1

Recommended increment: 1

Restriction: Height > 0 || Height == -1

Example (HDevelop)

dev_close_window ()
read_image (For5, 'for5')
get_image_size (For5, 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_extentsdev_set_window_extentsDevSetWindowExtentsDevSetWindowExtentsDevSetWindowExtents returns 2 (H_MSG_TRUE). Otherwise an exception is raised and an error code returned.

Possible Successors

dev_displaydev_displayDevDisplayDevDisplayDevDisplay, dev_set_lutdev_set_lutDevSetLutDevSetLutDevSetLut, dev_set_colordev_set_colorDevSetColorDevSetColorDevSetColor, dev_set_drawdev_set_drawDevSetDrawDevSetDrawDevSetDraw, dev_set_partdev_set_partDevSetPartDevSetPartDevSetPart

Module

Foundation