WoW:API CastSpellByName: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
No edit summary
m (Move page script moved page API CastSpellByName to API CastSpellByName without leaving a redirect)
 
(14 intermediate revisions by 12 users not shown)
Line 1: Line 1:
<center>'''CastSpellByName''' ''-Documentation by Sliver-''</center>
{{wowapi}}
----
{{protectedapi|2.0.1|For alternatives, try [[API_SecureTemplates|Secure Template]] or the new [[Conditional slash commands#/cast|/cast]].}}
;''Arguments''


:( name )
CastSpellByName(spellName{, onSelf});
:;name : String - Spell Name(as seen when mouse-over).


----
==Arguments==
;''Returns''
:;name : String - Name of the spell to cast. Rank is optional, if omitted, highest possible is picked automatically.
:;??
:;onSelf : Boolean - Should the spell be cast on the player (vs target)? If no target exists and the onSelf evaluates to false, cursor is switched to casting mode.
----
;''Example''
:( syntax )
:;CastSpellByName("spellname(Rank X)")
:;CastSpellByName("spellname")
 


CastSpellByName('Life Tap(Rank 2)')
==Example==
----
;''Result''


: Casts Life Tap (This example is warlock specific). When the (Rank X) string is omitted, the ''highest rank of the spell which the user has in his spellbook'' is cast.
CastSpellByName("Flash Heal(Rank 2)"); -- Cast Flash Heal (Rank 2) on target.
----
CastSpellByName("Flash Heal"); -- Cast Flash Heal (Highest rank) on target.
;''Description''
CastSpellByName("Flash Heal",1); -- Cast Flash Heal (Highest rank) on self.


: Casts a spell by the spells given name.
==Notes==
 
To cast spells that contains parentheses in the spell name, such as "Create Healthstone (Major)" and "Faerie Fire (Feral)", it's necessary to either specify rank or add () to the end of the spell name, like:
----
CastSpellByName("Faerie Fire (Feral)()");
;''Note:''
You might encounter difficulties when using this on a localized version of WoW.
: You might encounter difficulties when using this on a localized version of WoW.
* See the [[HOWTO:_Localize_an_AddOn#Unicode|Unicode part]] of the Localization HOWTO for more details about editing a source file containing localized strings.
: See the [[HOWTO:_Localize_an_AddOn#Unicode|Unicode part]] of the Localization HOWTO for more details about editing a source file containing localized strings.
* This problem does only appear when working with Lua source files. When you're using macros, inside the WoW client, it should work in unicode directly.
 
* You ''can'' still use this function outside of secure code to open trade skill windows and to summon non-combat pets and mounts.
: This problem does only appear when working with Lua source files. When you're using macros, inside the WoW client, it should work in unicode directly.
 
----
 
An FYI, as an antibot measure, this function only operates when called
directly from a button click.  If you try to call it from an event handler such as OnEvent(event) or OnUpdate(elapsed) it will not work.
{{Template:WoW API}}

Latest revision as of 04:45, 15 August 2023

← WoW API < CastSpellByName

Icon-addon-48x48.png This function is PROTECTED, and can only be called from Blizzard code. 
CastSpellByName(spellName{, onSelf});

Arguments

name
String - Name of the spell to cast. Rank is optional, if omitted, highest possible is picked automatically.
onSelf
Boolean - Should the spell be cast on the player (vs target)? If no target exists and the onSelf evaluates to false, cursor is switched to casting mode.

Example

CastSpellByName("Flash Heal(Rank 2)"); -- Cast Flash Heal (Rank 2) on target.
CastSpellByName("Flash Heal"); -- Cast Flash Heal (Highest rank) on target.
CastSpellByName("Flash Heal",1); -- Cast Flash Heal (Highest rank) on self.

Notes

To cast spells that contains parentheses in the spell name, such as "Create Healthstone (Major)" and "Faerie Fire (Feral)", it's necessary to either specify rank or add () to the end of the spell name, like: 

CastSpellByName("Faerie Fire (Feral)()");

You might encounter difficulties when using this on a localized version of WoW.

  • See the Unicode part of the Localization HOWTO for more details about editing a source file containing localized strings.
  • This problem does only appear when working with Lua source files. When you're using macros, inside the WoW client, it should work in unicode directly.
  • You can still use this function outside of secure code to open trade skill windows and to summon non-combat pets and mounts.
Retrieved from "https://addonstudio.org/mw1/index.php?title=WoW:API_CastSpellByName&oldid=10725"