transfer action to:
transfer action works only on transient items. You cannot transfer permanent items using this action.
To transfer objects to and from objects, and from workspaces to objects:
transfer {item | the attribute of item} to {item | the attribute of item}
transfer my-variable to the volume of gas-tank
gas-tank must have an existing volume attribute.
To transfer an object attribute to a workspace:
transfer the temp of tank1 to new-workspace at (50, 50)
To transfer an object attribute to another object:
transfer the temp of tank1 to the new-temp of specialty-pump
To transfer an object upon a workspace to the attribute of an object:
transfer tank1 to the equipment of tank-holder
temperature-var is a float-variable, which you transfer to be the temp attribute of new-object, you can change the value of temperature-var with either of these statements:
conclude that temperature-var = 100.6
conclude that the temp of new-object = 100.6
To transfer a transient item to the mouse:
transfer item to the mouse of g2-window
When entering a
transfer item to the mouse action, the Text Editor includes a prompt for a positioning statement, such as at (x, y). Adding such a statement has no effect on the transfer action. The item is simply transferred to the mouse at its current location. In the next example from the text of an action button, G2 creates a new connection post in the current window and transfers it to the mouse. In this case, the connection post will appear attached to the mouse pointer at its current position. Clicking the mouse places the item on the workspace. Action buttons can use the statement
this window to refer to the current G2 window.
![]() |
Note: You cannot transfer a connected item to the mouse.
If the user has already pressed down a mouse button when the transfer to the mouse action begins, the user must release that button and press a mouse button again for G2 to transfer the item to a workspace. Transferring More Than One Item to the Mouse
You can use the transfer item to the mouse action to attach more than one item to the mouse. If you do so, G2 queues the items in a last-in, first-out basis. Transferring an Item to a Workspace
To transfer an item from one workspace to another, or to transfer an item that is not on a workspace to a workspace:
transfer item to {kb-workspace [at (x, y) ]
at (x, y) statement represents the workspace unit integer values that specify the horizontal and vertical coordinates of the item upon the target workspace. An example is:
![]() |
Removing an Item from a Workspace
To remove an item from a workspace:
transfer item off
![]() |