WoW:API UseAction: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
(switched to new template, moved ActionSlot code to the ActionSlot page)
m (Move page script moved page API UseAction to API UseAction without leaving a redirect)
 
(4 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{wowapi}} __NOTOC__
{{wowapi}}
{{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 7: Line 8:
== Parameters ==
== Parameters ==
=== Arguments ===
=== Arguments ===
 
:;slot
:(slot[, checkCursor[, onSelf]])
:: Numeric - The action [[ActionSlot|slot]] to use.
:;slot : Numeric - The action [[API TYPE ActionSlot|slot]] to use.
:;checkCursor
:;checkCursor : Flag <small><i>(optional)</i></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.
:: 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><i>(optional)</i></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.
:;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 ===
Line 29: Line 31:
== Details ==
== Details ==


See [[API TYPE ActionSlot|ActionSlot]] for more information on slot numbers and example code for listing available slots.
See the [[actionSlot]] API Type for more information on slot numbers and example code for listing available slots.

Latest revision as of 04:47, 15 August 2023

← WoW API < UseAction

Icon-addon-48x48.png 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.

Retrieved from "https://addonstudio.org/mw1/index.php?title=WoW:API_UseAction&oldid=9681"