dev_set_tool_geometrydev_set_tool_geometryDevSetToolGeometrydev_set_tool_geometryDevSetToolGeometryDevSetToolGeometry (Operator)

Name

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

Signature

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

dev_set_tool_geometrydev_set_tool_geometryDevSetToolGeometrydev_set_tool_geometryDevSetToolGeometryDevSetToolGeometry sets the position and dimension of the tool with the id ToolIdToolIdToolIdToolIdToolIdtoolId.

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

The parameters RowRowRowRowRowrow and ColumnColumnColumnColumnColumncolumn can be used to modify the position of the tool. In order to unmodify the position 'default'"default""default""default""default""default" can be passed.

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

Attention

This operator is not supported for code export.

Parameters

ToolIdToolIdToolIdToolIdToolIdtoolId (input_control) dev_tool → (string)

Tool identifier.

RowRowRowRowRowrow (input_control) rectangle.origin.y → (integer / string)

Row index of upper left corner.

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

Minimum increment: 1

Recommended increment: 1

ColumnColumnColumnColumnColumncolumn (input_control) rectangle.origin.x → (integer / string)

Column index of upper left corner.

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

Minimum increment: 1

Recommended increment: 1

WidthWidthWidthWidthWidthwidth (input_control) rectangle.extent.x → (integer / string)

Width of the tool.

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

Minimum increment: 1

Recommended increment: 1

Restriction: Width > 0

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

Height of the tool.

Default value: '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_toolDevOpenTooldev_open_toolDevOpenToolDevOpenTool returns 2 (H_MSG_TRUE). Otherwise an exception is raised and an error code returned.