Editing WoW:API CreateMacro

{{wowapi}}
Creates a new macro command/button.

  CreateMacro(name, iconFileName, body, perCharacter)

== Arguments ==
:(name, iconFileName, body, perCharacter)

; name : String - The name of the macro to be displayed in the UI. The current UI imposes a 16-character limit.

; iconFileName : String , The icon name.

; body : String - The macro commands to be executed. If this string is longer than 255 characters, only the first 255 will be saved.

; perCharcter : Numeric - nil will create a "General" saved macro, 1 will save it as "Per Character"

== Returns ==

; macroId : Numeric - The 1-based index of the newly-created macro, as displayed in the "Create Macros" UI.

== Example ==
; General (All Character) Macros :
 local macroId = CreateMacro("MyMacro", "INV_MISC_QUESTIONMARK", "/script CastSpellById(1);", nil);

; perChar (Per Character) Macros :
 local macroId = CreateMacro("MyMacro", "INV_MISC_QUESTIONMARK", "/script CastSpellById(1);", 1);

== Notes ==
* As of [[Patch 4.3]] this is working as shown - the unused parameter has been removed.
* This function will generate an error if the maximum macros of the specified kind already exist (36 for per acount and 18 for per character).
* It is possible to create macros with duplicate names. You should enumerate the current macros using [[API GetNumMacros|GetNumMacros()]] and [[API GetMacroIconInfo|GetMacroIconInfo(macroId)]] to ensure that your new macro name doesn't already exist. Macros with duplicate names can be used in most situations, but the behavior of macro functions that retrieve a macro by name is undefined when multiple macros of that name exist.
* This function may not be called in combat anymore, as of [[Patch 2.0]].