WoW:API UseAction: Difference between revisions
Jump to navigation
Jump to search
m (Robot: converting/fixing HTML) |
mNo edit summary |
||
| Line 1: | Line 1: | ||
{{wowapi}} | {{wowapi}} | ||
{{protectedapi|2.0.1|For alternatives, try [[ | {{protectedapi|2.0.1|For alternatives, try [[API SecureTemplates|SecureTemplates]] or the new [[Conditional slash commands]].}} | ||
Perform the specified action. | Perform the specified action. | ||
UseAction(slot[, checkCursor[, onSelf]]) | UseAction(slot[, checkCursor[, onSelf]]) | ||
| Line 8: | Line 8: | ||
== Parameters == | == Parameters == | ||
=== Arguments === | === Arguments === | ||
:;slot : Numeric - The action [[ActionSlot|slot]] to use. | :;slot | ||
:;checkCursor : Flag <small>''(optional)''</small> - Can be 0, 1, or nil. Appears to indicate whether the action button was clicked (1) or used via hotkey (0); probably involved in placing skills/items in the action bar after they've been picked up. | :: Numeric - The action [[ActionSlot|slot]] to use. | ||
:;onSelf : Flag <small>''(optional)''</small> - Can be 0, 1, or nil. If present and 1, then the action is performed on the player, not the target. | :;checkCursor | ||
:: Flag <small>''(optional)''</small> - Can be 0, 1, or nil. Appears to indicate whether the action button was clicked (1) or used via hotkey (0); probably involved in placing skills/items in the action bar after they've been picked up. I can confirm this. If you pass 0 for checkCursor, it will use the action regardless of whether another item/skill is on the cursor. If you pass 1 for checkCursor, it will replace the spell/action on the slot with the new one. | |||
:;onSelf | |||
:: Flag <small>''(optional)''</small> - Can be 0, 1, or nil. If present and 1, then the action is performed on the player, not the target. If "true" is passed instead of 1, Blizzard produces a Lua error. | |||
=== Returns === | === Returns === | ||
Revision as of 19:47, 25 September 2013
|
This function is PROTECTED, and can only be called from Blizzard code.
|
Perform the specified action.
UseAction(slot[, checkCursor[, onSelf]])
Parameters
Arguments
- slot
- Numeric - The action slot to use.
- checkCursor
- Flag (optional) - Can be 0, 1, or nil. Appears to indicate whether the action button was clicked (1) or used via hotkey (0); probably involved in placing skills/items in the action bar after they've been picked up. I can confirm this. If you pass 0 for checkCursor, it will use the action regardless of whether another item/skill is on the cursor. If you pass 1 for checkCursor, it will replace the spell/action on the slot with the new one.
- onSelf
- Flag (optional) - Can be 0, 1, or nil. If present and 1, then the action is performed on the player, not the target. If "true" is passed instead of 1, Blizzard produces a Lua error.
Returns
- none
Example
action = 18 -- Change this to the slot number you want to activate UseAction(action, 0, 1)
Result
-- Causes action bar slot #18 to be cast on the player, regardless -- of whether the cursor is currently "holding" an item or ability.
Details
See the actionSlot API Type for more information on slot numbers and example code for listing available slots.