WoW:API GetMacroIndexByName: Difference between revisions

Latest revision as of 04:46, 15 August 2023

Reference e
AddOns WoW API Widget API XML UI Event API WoW Lua Macro API CVars Battle.net HOWTOs Snippets UI tech Categories

Return macro index for a given name.

macroIndex = GetMacroIndexByName("name")

macroIndex: The numeric index of the macro or 0 if there's no macro with the given name.

Macros are indexed 1-36 for "global" macros and 37-54 for character-specific macros.

If there is two or more macros with the same name, it appears to return the highest macroIndex found.

local macroIndex = GetMacroIndexByName("Fred")
if macroIndex == 0 then
  -- You have no macro named "Fred"
end

@@ Line 1: / Line 1: @@
 {{wowapi}}
-<center>'''GetMacroInfo''' - ''Documentation by [[User:Kaso|Kaso]]''</center>
-Return Macro Index For Given Name
+Return macro index for a given name.
-  Returns macroid = GetMacroIndexByName("name")
+  macroIndex = GetMacroIndexByName("name")
 == Arguments ==
-:("name")
-:;"name": String - The name of macro As Obtainable By GetActionText(slot)
+:;"name" : String - The name of a macro as obtainable by GetActionText(slot)
 == Returns ==
-:;MacroID
+:;macroIndex : The numeric index of the macro or 0 if there's no macro with the given name.
-:The Numeric Index of the macro
 == Notes ==
-:If there Is two or more macros with the Same Name, it appears to return the highest macroid found.
+:Macros are indexed 1-36 for "global" macros and 37-54 for character-specific macros.
+:If there is two or more macros with the same name, it appears to return the highest macroIndex found.
 == Example ==
-  local macroid = GetMacroIndexByName("Fred")
+  local macroIndex = GetMacroIndexByName("Fred")
+ if macroIndex == 0 then
+   -- You have no macro named "Fred"
+ end