Operator Reference

HALCON Operator Reference / Develop

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

Use the tabs on the upper right to switch to a different programming language.

Use the tabs on the upper right to switch to a different programming language.

Use the tabs on the upper right to switch to a different programming language.

Use the tabs on the upper right to switch to a different programming language.

dev_set_tool_geometrydev_set_tool_geometryDevSetToolGeometryDevSetToolGeometrydev_set_tool_geometry (Operator)

dev_set_tool_geometrydev_set_tool_geometryDevSetToolGeometryDevSetToolGeometrydev_set_tool_geometry — Sets the position and size of the specified tool.

Signature

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

Herror dev_set_tool_geometry(const char* ToolId, const Hlong Row, const Hlong Column, const Hlong Width, const Hlong Height)

Herror T_dev_set_tool_geometry(const Htuple ToolId, const Htuple Row, const Htuple Column, const Htuple Width, const Htuple Height)

void DevSetToolGeometry(const HTuple& ToolId, const HTuple& Row, const HTuple& Column, const HTuple& Width, const HTuple& Height)

static void HOperatorSet.DevSetToolGeometry(HTuple toolId, HTuple row, HTuple column, HTuple width, HTuple height)

def dev_set_tool_geometry(tool_id: HHandle, row: Union[int, str], column: Union[int, str], width: Union[int, str], height: int) -> None

Description

dev_set_tool_geometrydev_set_tool_geometryDevSetToolGeometryDevSetToolGeometrydev_set_tool_geometry sets the position and dimension of the tool with the id ToolIdToolIdToolIdtoolIdtool_id.

Instead of using the ToolIdToolIdToolIdtoolIdtool_id, given during opening the tool, you can use the name that has to be used in dev_open_tooldev_open_toolDevOpenToolDevOpenTooldev_open_tool. In that case a arbitrary tool, which fits the parameter ToolIdToolIdToolIdtoolIdtool_id, is used.

The parameters RowRowRowrowrow and ColumnColumnColumncolumncolumn can be used to modify the position of the tool. 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”. In order to unmodify the position 'default'"default""default""default""default" can be passed.

The parameters WidthWidthWidthwidthwidth and HeightHeightHeightheightheight can be used to modify the size of the tools. In order to unmodify the size 'default'"default""default""default""default" can be passed. If WidthWidthWidthwidthwidth and HeightHeightHeightheightheight are less than the minimum size of the tool the minimum size is used.

Attention

This operator is not supported for code export.

Parameters

ToolIdToolIdToolIdtoolIdtool_id (input_control)  dev_tool → HTupleHHandleHTupleHtuple (string) (IntPtr) (HString) (char*)

Tool identifier.

RowRowRowrowrow (input_control)  rectangle.origin.y → HTupleUnion[int, str]HTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)

Row index of upper left corner.

Default: 'default' "default" "default" "default" "default"

Minimum increment: 1

Recommended increment: 1

ColumnColumnColumncolumncolumn (input_control)  rectangle.origin.x → HTupleUnion[int, str]HTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)

Column index of upper left corner.

Default: 'default' "default" "default" "default" "default"

Minimum increment: 1

Recommended increment: 1

WidthWidthWidthwidthwidth (input_control)  rectangle.extent.x → HTupleUnion[int, str]HTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)

Width of the tool.

Default: 'default' "default" "default" "default" "default"

Minimum increment: 1

Recommended increment: 1

Restriction: Width > 0

HeightHeightHeightheightheight (input_control)  rectangle.extent.y → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Height of the tool.

Default: 'default' "default" "default" "default" "default"

Minimum increment: 1

Recommended increment: 1

Restriction: Height > 0

Example (HDevelop)

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

Result

If the values of the specified parameters are correct, dev_open_tooldev_open_toolDevOpenToolDevOpenTooldev_open_tool returns 2 ( H_MSG_TRUE) . Otherwise, an exception is raised and an error code returned.

Possible Predecessors

dev_open_tooldev_open_toolDevOpenToolDevOpenTooldev_open_tool

Possible Successors

dev_show_tooldev_show_toolDevShowToolDevShowTooldev_show_tool, dev_close_tooldev_close_toolDevCloseToolDevCloseTooldev_close_tool

Alternatives

dev_show_tooldev_show_toolDevShowToolDevShowTooldev_show_tool

See also

dev_show_tooldev_show_toolDevShowToolDevShowTooldev_show_tool

Module

Foundation

---

ClassesClasses | | Operators