WoW:API CastSpellByName: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
m (Usage Restriction.)
m (cat)
Line 43: Line 43:
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.
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}}
{{Template:WoW API}}
[[Category:API Spell Functions|CastSpellByName]]

Revision as of 02:30, 4 January 2006

CastSpellByName -Documentation by Sliver-

Arguments
( name )
name
String - Spell Name(as seen when mouse-over).

Returns
??

Example
( syntax )
CastSpellByName("spellname(Rank X)")


CastSpellByName('Life Tap(Rank 2)')

Result
Casts life tap on player(This example is warlock specific).

Description
Casts a spell by the spells given name.

Note:
You might encounter difficulties when using this on a localized version of WoW.
Get the exact name and suffix of the Spell by using the GetSpellName-function. If the spell's name includes special characters (like ä, á, â,...) you will have to use utf8-escape codes (which you can find here).
This is because Lua currently does not support unicode!
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.

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