WoW:API CastSpellByName: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
m (cat)
mNo edit summary
Line 28: Line 28:
;''Note:''
;''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.
: 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]).
: 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 is because Lua currently does not support unicode!


: For example, if you're using the german version of the WoW-client, instead of
: 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.
  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.


----
----

Revision as of 15:29, 22 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.
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.

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