MOVE.TOOL macro

Moves or copies a button from one toolbar to another.

Syntax

MOVE.TOOL(from_bar_id, from_bar_position, to_bar_id, to_bar_position, copy, width)

From_bar_id    specifies the number or name of a toolbar from which you want to move or copy the button. For detailed information, see the description of bar_id in ADD.TOOL.

From_bar_position    specifies the current position of the button within the toolbar. From_bar_position starts with 1 at the left side (if horizontal) or at the top (if vertical).

To_bar_id    specifies the number or name of a toolbar to which you want to move or paste the button. For detailed information, see the description of bar_id in ADD.TOOL. To_bar_id is optional if you are moving a button within the same toolbar.

To_bar_position    specifies where you want to move or paste the button within the toolbar. To_bar_position starts with 1 at the left side (if horizontal) or at the top (if vertical). To_bar_position is optional if you are only adjusting the width of a drop-down list.

Copy    is a logical value specifying whether to copy the button. If copy is TRUE, the button is copied; if FALSE or omitted, the button is moved.

Width    is the width, measured in points, of a drop-down list. If the button you are moving is not a drop-down list, width is ignored.

Related Functions

ADD.TOOL   Adds one or more buttons to a toolbar

COPY.TOOL   Copies a button face to the Clipboard

GET.TOOL   Returns information about a button or buttons on a toolbar

Return to index