WoW:API CastSpellByName: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
mNo edit summary
m (Move page script moved page API CastSpellByName to API CastSpellByName without leaving a redirect)
 
(18 intermediate revisions by 16 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('Life Tap(Rank 2)')
==Example==
----
;''Result''


: Casts life tap on player(This example is warlock specific).
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.
: Get the exact name and suffix of the Spell by using the [[API_GetSpellName|GetSpellName]]-function. If the spell's name includes special characters (like ä, á, â,...) you will have to use utf8-escape codes (which you can find [http://www.allegro-c.de/unicode/zcodes.htm here]).
* 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.
: This is because Lua currently does not support unicode!
* You ''can'' still use this function outside of secure code to open trade skill windows and to summon non-combat pets and mounts.
 
: For example, if you're using the german version of the WoW-client, instead of
  CastSpellByName("Dämonenrüstung(Rang 1)");
: you will have to write
  CastSpellByName("D\195\164monenr\195\188stung(Rang 1)");
 
: This problem does only appear when working with Lua. When you're just using macro it should work with the ä's and ü's.
 
----
{{Template:WoW API}}
[[Category:API Spell Functions|CastSpellByName]]

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"