WoW:API PickupMacro: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
({{protectedcombatapi|2.2}})
m (macroName)
Line 4: Line 4:
Pick up a macro from the macro frame and place it on the cursor
Pick up a macro from the macro frame and place it on the cursor


  PickupMacro(macroID)
  PickupMacro("macroName" or macroID)


== Arguments ==
== Arguments ==


:;macroID : Number - the position of the macro in the macro frame. Starting at the top left macro with 1, counting from left to right and top to bottom. The IDs of the first page (all characters) range from 1-18, the second page 19-36.
:;macroName: String - the name of the macro.
:;macroID : Number - the position of the macro in the macro frame. Starting at the top left macro with 1, counting from left to right and top to bottom. The IDs of the first page (all characters) range from 1-18, the second page 19-36.  Note that this index may change as macros are added or deleted.




== Example ==
== Example ==
  PickupMacro(25);
PickupMacro("Reload")
  PickupMacro(25)


===Result===
===Result===
:The macro named "Reload" is placed on the cursor.  If there is no such named macro then nothing happens.
:The macro located on the second page of the macro frame, middle row, far left will be placed on the mouse cursor and can be dropped onto any action button. If this position is empty (no macro in that slot defined), nothing happens.
:The macro located on the second page of the macro frame, middle row, far left will be placed on the mouse cursor and can be dropped onto any action button. If this position is empty (no macro in that slot defined), nothing happens.


==Uncertainties==
==Note==
If you use a MacroID argument which is greater than 36, nothing seems to happen. However, I haven't yet figured out whether the function just ignores such arguments, or this ignorance is just a side-effect of the 36 macro limit of the standard UI.
Currently a macroID argument which is greater than 36 returns nothing. There are only 36 macro slots as of 3.0.3.

Revision as of 17:54, 9 November 2008

← WoW API < PickupMacro

Icon-addon-48x48.png This function is protected, and cannot be called from insecure code while in in combat.
  • It has been protected since patch 2.2.

Pick up a macro from the macro frame and place it on the cursor 

PickupMacro("macroName" or macroID)

Arguments

macroName
String - the name of the macro.
macroID
Number - the position of the macro in the macro frame. Starting at the top left macro with 1, counting from left to right and top to bottom. The IDs of the first page (all characters) range from 1-18, the second page 19-36. Note that this index may change as macros are added or deleted.


Example

PickupMacro("Reload")
PickupMacro(25)

Result

The macro named "Reload" is placed on the cursor. If there is no such named macro then nothing happens.
The macro located on the second page of the macro frame, middle row, far left will be placed on the mouse cursor and can be dropped onto any action button. If this position is empty (no macro in that slot defined), nothing happens.

Note

Currently a macroID argument which is greater than 36 returns nothing. There are only 36 macro slots as of 3.0.3.

Retrieved from "https://addonstudio.org/mw/index.php?title=WoW:API_PickupMacro&oldid=12786"