Difference between revisions of "VisionaireObject Command: clearLink"
From The Official Visionaire Studio: Adventure Game Engine Wiki
| (One intermediate revision by the same user not shown) | |||
| Line 17: | Line 17: | ||
|- | |- | ||
| field | | field | ||
| − | | | + | | integer |
| The object field to be cleared; has to be of "t_link" type. | | The object field to be cleared; has to be of "t_link" type. | ||
''Specify the field constant name (V + object table name in singular + field name) or the field id, see the example.'' | ''Specify the field constant name (V + object table name in singular + field name) or the field id, see the example.'' | ||
| Line 32: | Line 32: | ||
'''Example 1:''' Clear the link to the currently used item (will remove a dragged item from the cursor). | '''Example 1:''' Clear the link to the currently used item (will remove a dragged item from the cursor). | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
| − | -- Specify the field constant name | + | -- Specify the field constant name or the field id |
game:clearLink(VGameUsedItem) | game:clearLink(VGameUsedItem) | ||
| − | |||
| − | |||
game:clearLink(686) | game:clearLink(686) | ||
Latest revision as of 21:13, 11 August 2023
Removes a link from the VisionaireObject.
Syntax
clearLink(field)
Parameters
| Parameter | Type | Description |
|---|---|---|
| field | integer | The object field to be cleared; has to be of "t_link" type.
Specify the field constant name (V + object table name in singular + field name) or the field id, see the example. |
Return values
none
Examples
Example 1: Clear the link to the currently used item (will remove a dragged item from the cursor).
-- Specify the field constant name or the field id
game:clearLink(VGameUsedItem)
game:clearLink(686)
-- Setting an empty object leads to the same result
game:setValue(VGameUsedItem, emptyObject)
-- The shorthand notation offers a more convenient way to achieve the same
game.UsedItem = emptyObject
