Wiley-World.of.Warcraft.Programming.A.Guide.and.Reference.for.Creating.WoW.Addons

Appendix A ■ Best Practices 1325function MyAddon_OnHyperlinkClick(self, link, text, button)if button == “LeftButton“ thenself.link = linkprint(“You clicked on “..text)endendAs you can see, this corresponds to self, arg1 corresponds to link, arg2corresponds to text, andarg3 corresponds to button. With the exception ofthe OnEvent handler, this and arg1-argn will always match the parameter listof the given handler. In this way, you can use the widget handler referencein Chapter 31 to determine the meanings of the global arguments in anylegacy code. The only difference with OnEvent is that event always had itsown global. arg1-argn, in this case, correspond to the parameters passedthrough ....bag and slot Attributes on item Type Action ButtonsAnother change in 2.1 is the simplification of secure action buttons with a“type“ attribute of “item“. Previously, the “item“ attribute could only beused to activate an item by name. To use an item in your inventory wouldrequire a “slot“ attribute; to use an item in your bags required “bag“ and“slot“ attributes. Now the “item“ attribute works the same way as the /usemacro command. It accepts an item name, item ID (in the form “item:12345“),slot number, or bag and slot numbers separated by a space (for example,“3 12“).Again, for backward compatibility, the “bag“ and “slot“ attributes arestill supported. However, you should no longer use them; as a comment inFrameXML\SecureTemplates.lua says, ‘‘Backward compatibility code, deprecatedbut still handled for now.’’ [Emphasis mine.]Avoiding Common MistakesAddon authors can make dozens of common mistakes as they develop theiraddons. Many of them have been covered throughout the book, but thefollowing deserve to be mentioned here, as well.Adding Files While WoW Is RunningWhen World of Warcraft loads, it scans the file system and builds a table offiles that can be loaded during that session. If you add files while the game isopen, they won’t be part of that table and cannot be loaded or recognized bythe game. A related common mistake is adding a new file to your addon andthe Table of Contents file without fully exiting the game.If you add files to the file system, make sure that you fully exit and restartthe game so that the changes will be fully registered.