WoW:API UseAction: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
m (Tweaked the example code so it would not cause an error on blank button slots.)
m (Move page script moved page API UseAction to API UseAction without leaving a redirect)
 
(8 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<center>'''UseAction''' - ''Documentation by [[User:Sarf|Sarf]]''</center>
{{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])
== Parameters ==
== Parameters ==
=== Arguments ===
=== Arguments ===
:(slot [,checkCursor] [,onSelf])
:;slot
:: Numeric - The action [[ActionSlot|slot]] to use.
:;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 ===
 
:''none''
 
== Example ==


:;slot : Numeric - The action slot to use.
action = 18 -- Change this to the slot number you want to activate
:;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.
UseAction(action, 0, 1)
:;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.


== Details ==
=== Result ===
: Each button on your action bar has an ID. The first button id is 1, and so on. There are 6 action bars in all, thus the highest action bar is 72. With the addition of ver 1300, Page 3 acts as the Right Action bar, page 4 acts as the second Right action bar, page 5 acts as the Bottom Right bar, and page 6 acts as the Bottom Left bar.


; Update 31-Dec-2005 : Action bar SlotID's have been seen as high as 120 and may go even higher. Druids are lucky enough to get extra action bars for some of their forms (Bear Form, Cat Form, but apparently not Aquatic Form or Travel Form). The following code enumerates the (/macro) name and texture for all assigned action bar slots:
-- Causes action bar slot #18 to be cast on the player, regardless
-- of whether the cursor is currently "holding" an item or ability.


function reportActionButtons()
== Details ==
  local lActionSlot = 0
  for lActionSlot = 1, 128 do
  local lActionText = GetActionText(lActionSlot)
  if not(lActionText) then lActionText = "" end
  local lActionTexture = GetActionTexture(lActionSlot)
  if (lActionText) and (lActionTexture) then
    local lMessage = lActionSlot..". "..lActionText
    lMessage = lMessage.." ["..lActionTexture.."]"
    DEFAULT_CHAT_FRAME:AddMessage(lMessage)
  end
  end
end


----
See the [[actionSlot]] API Type for more information on slot numbers and example code for listing available slots.
__NOTOC__
{{Template:WoW API}}

Latest revision as of 04:47, 15 August 2023

WoW API < UseAction

Perform the specified action.

UseAction(slot[, checkCursor[, onSelf]])

Parameters[edit]

Arguments[edit]

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[edit]

none

Example[edit]

action = 18 -- Change this to the slot number you want to activate
UseAction(action, 0, 1)

Result[edit]

-- Causes action bar slot #18 to be cast on the player, regardless
-- of whether the cursor is currently "holding" an item or ability.

Details[edit]

See the actionSlot API Type for more information on slot numbers and example code for listing available slots.