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

670 Part IV ■ ReferenceReturns:action—Name of the action associated with the key, or the empty string (““) ifthe key is not bound to an action (string)GetBindingByKeyReturns the action bound to a key or key combination.action = GetBindingByKey(“key“)Arguments:key—A key or key combination (e.g. ‘‘CTRL-2‘‘) (string, binding)Returns:action—Name of the action associated with the key, or the empty string (““) ifthe key is not bound to an action (string)GetBindingKeyReturns the key combinations for a given binding command.key1, ... = GetBindingKey(“COMMAND“)Although the default UI only allows two combinations to be bound to acommand, more than two can be set via the API.Arguments:COMMAND—Name of a binding command (string)Returns:key1—First key binding for the command, or nil if no key is bound (string,binding)...—A list of additional bindings for the command (list)GetBlockChanceReturns the player’s percentage chance to block with a shield.chance = GetBlockChance()Returns:chance—Percentage chance to block (number)GetBonusBarOffsetReturns the current ‘‘stance’’ offset for use with the bonus action bar.offset = GetBonusBarOffset()This value corresponds to what ‘‘stance’’ the player is currently in, and morespecifically which set of actions correspond to that stance. Action IDs forspecial stances start on action bar #7 (or NUM_ACTIONBAR_PAGES + 1), so theoffset returned by this function corresponds to the number to be added toNUM_ACTIONBAR_PAGES in calculating action IDs for these action bars.Note that the UI definition of ‘‘stance’’ includes not just warrior stances butalso druid shapeshift forms, rogue/druid stealth, priest shadowform, andvarious other cases, but does not necessarily include all states normallypresented in the default UI’s stance/shapeshift bar (notable exclusions arepaladin auras and death knight presences).