dev_set_window_extentsdev_set_window_extentsDevSetWindowExtentsDevSetWindowExtentsdev_set_window_extents (算子)

名称

dev_set_window_extentsdev_set_window_extentsDevSetWindowExtentsDevSetWindowExtentsdev_set_window_extents — 更改活动浮动图形窗口的位置和大小。

签名

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

描述

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

The parameters RowRowRowRowrowrow and ColumnColumnColumnColumncolumncolumn specify the new position (upper left corner) of the window. Note that the offset values specified under Edit -> Preferences -> General Options -> General Options -> Window open offset are added to the row and the column index, respectively. For more information, see the chapter “Menu Edit” in the “HDevelop User's Guide”. Negative coordinates of the position are ignored, i.e., in this direction the window will not be moved.

The parameters WidthWidthWidthWidthwidthwidth and HeightHeightHeightHeightheightheight 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.

注意

This operator only works for single floating graphics windows, i.e., graphics windows that are neither docked nor tabbed.

Never use set_window_extentsset_window_extentsSetWindowExtentsSetWindowExtentsSetWindowExtentsset_window_extents to change the size and position of an HDevelop graphics window. The operator dev_set_window_extentsdev_set_window_extentsDevSetWindowExtentsDevSetWindowExtentsDevSetWindowExtentsdev_set_window_extents 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.

参数

RowRowRowRowrowrow (输入控制) rectangle.origin.y → (integer)

Row index of upper left corner.

默认值： 0

最小增量： 1

建议增量： 1

限制： Row >= 0 || Row == -1

ColumnColumnColumnColumncolumncolumn (输入控制) rectangle.origin.x → (integer)

Column index of upper left corner.

默认值： 0

最小增量： 1

建议增量： 1

限制： Column >= 0 || Column == -1

WidthWidthWidthWidthwidthwidth (输入控制) rectangle.extent.x → (integer)

Width of the window.

默认值： 256

最小增量： 1

建议增量： 1

限制： Width > 0 || Width == -1

HeightHeightHeightHeightheightheight (输入控制) rectangle.extent.y → (integer)

Height of the window.

默认值： 256

最小增量： 1

建议增量： 1

限制： Height > 0 || Height == -1

示例（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)

结果

If the values of the specified parameters are correct, dev_set_window_extentsdev_set_window_extentsDevSetWindowExtentsDevSetWindowExtentsDevSetWindowExtentsdev_set_window_extents 返回 2 ( H_MSG_TRUE )。否则，将抛出一个异常并返回错误代码。

可能的后继

dev_displaydev_displayDevDisplayDevDisplayDevDisplaydev_display, dev_set_lutdev_set_lutDevSetLutDevSetLutDevSetLutdev_set_lut, dev_set_colordev_set_colorDevSetColorDevSetColorDevSetColordev_set_color, dev_set_drawdev_set_drawDevSetDrawDevSetDrawDevSetDrawdev_set_draw, dev_set_partdev_set_partDevSetPartDevSetPartDevSetPartdev_set_part

另见

set_window_extentsset_window_extentsSetWindowExtentsSetWindowExtentsSetWindowExtentsset_window_extents

模块

基础

算子