halcon算子翻译——dev_set_tool_geometry

名称

dev_set_tool_geometry - 设置指定tool的位置和大小。

用法

dev_set_tool_geometry( : : ToolId, Row, Column, Width, Height : )

描述

　　dev_set_tool_geometry使用ToolId的id来设置tool的位置和尺寸。

　　传递ToolId还有种替代方案，可以传递在算子dev_open_tool中使用的名称。 在这种情况下，任意的符合条件的参数ToolId都会使用到。（经验<非原翻译>：如果在此算子中直接传递tool名称，只会作用到最新的打开的tool。）

　　参数Row和Column可以用来修改tool的位置。 为了不改变该位置，可以传递'default'。

　　参数Width和Height可以用来修改tool的大小。 为了不改变大小，可以传递'default'。 如果Width和Height小于tool的最小尺寸，则使用最小尺寸。

注意

此算子不支持代码导出

参数

ToolId (input_control) 　　dev_tool → (string)
　　Tool identifier.

Row (input_control) 　　 rectangle.origin.y → (integer / string)
　　Row index of upper left corner.
　　Default value: 'default'
　　Minimum increment: 1
　　Recommended increment: 1

Column (input_control)　　 rectangle.origin.x → (integer / string)
　　Column index of upper left corner.
　　Default value: 'default'
　　Minimum increment: 1
　　Recommended increment: 1

Width (input_control)　　 rectangle.extent.x → (integer / string)
　　Width of the tool.
　　Default value: 'default'
　　Minimum increment: 1
　　Recommended increment: 1
　　Restriction: Width > 0

Height (input_control) 　　 rectangle.extent.y → (integer)
　　Height of the tool.
　　Default value: 'default'
　　Minimum increment: 1
　　Recommended increment: 1
　　Restriction: Height > 0

示例（HDevelop）

dev_open_tool ('zoom_window', 0, 0, Width, 'default', ToolId)
dev_close_tool (ToolId)

结果

如果指定参数的值正确，则dev_open_tool返回2（H_MSG_TRUE）。 否则会引发异常并返回错误代码。

Possible Predecessors

dev_open_tool

Possible Successors

dev_show_tool, dev_close_tool

备选算子

dev_show_tool

See also

dev_show_tool

模块

Foundation

HDevelop例程

dev_open_tool.hdev 　　Open and adjust tools in HDevelop