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

Chapter 29 ■ Widget Reference 1123HasScriptReturns whether the widget supports a script handler.hasScript = ScriptObject:HasScript(“scriptType“)Arguments:scriptType—A script type; see scripts reference for details (string)Returns:hasScript—1 if the widget can handle the script, otherwise nil (1nil)HookScriptSecurely hooks a script handler.ScriptObject:HookScript(“scriptType“, handler)Equivalent to hooksecurefunc() for script handlers; allows one to‘‘post-hook’’ a secure handler without tainting the original.The original handler will still be called, but the handler supplied will also becalled after the original, with the same arguments. Return values from thesupplied handler are discarded. Note that there is no API to remove a hookfrom a handler: any hooks applied will remain in place until the UI is reloaded.If there was no prior script handler set, then this simply sets the new functionas the handler for the script type.Arguments:scriptType—Name of the script whose handler should be hooked (string)handler—A function to be called whenever the script handler is run(function)Example:-- hooks the default UI’s player frame to insert a chat link to the-- player’s most recently completed achievement when shift-clickedfunction PlayerLink(self, button, down)if ( IsModifiedClick(“CHATLINK“) ) thenlocal link = iGetAchievementLink(select(1,GetLatestCompletedAchievements()))ChatEdit_InsertLink (link)endendPlayerFrame:HookScript(“OnClick“, PlayerLink)SetScriptSets the widget’s handler function for a script.ScriptObject:SetScript(“scriptType“, handler)Arguments:scriptType—A script type; see scripts for details (string)handler—A function to become the widget’s handler for the script type(function)