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

Chapter 16 ■ Binding Keys and Clicks to Addon Code 311...The name attribute, in this case TOGGLESHEATH, sets the name of this particularaction. You use this name with the SetBinding() functions later in thischapter. The key binding interface looks for a global string variable calledBINDING_NAME_name to label the binding in the list. For example, the valueof BINDING_NAME_TOGGLESHEATH is Sheath/Unsheath Weapon in the Englishversion of WoW (see Figure 16-1).Once you bind a key to a command, the code inside the Binding tagis executed whenever you press the key. In this case, because Z is boundto TOGGLESHEATH, pressing Z calls the ToggleSheath function, which cyclesthrough your equipped weapons.NOTE There are certain situations in which key bindings might not appear towork correctly, such as when you try to use a keyboard binding while an EditBoxwidget has the keyboard focus. Similarly for mouse buttons, any time the cursor isover a mouse-enabled frame, the frame consumes button clicks for use withOnClick, OnMouseDown, and so on, whether or not the handlers have beendefined for the frame.Key bindings are consulted only if the keys or buttons aren’t consumed by someother aspect of the user interface.Here’s another example from the built-in Bindings.xml that illustrates acouple more features:if ( keystate == “down“ ) thenMoveAndSteerStart();elseMoveAndSteerStop();endAs with the previous example, this binding includes a name attributeand a Lua chunk. The new header attribute sets up a heading for the keybinding interface. In this case WoW looks for BINDING_HEADER_to determine the text of the header. You can see in Figure 16-1 thatBINDING_HEADER_MOVEMENT is defined as Movement Keys in the English client.Of particular note is the runOnUp attribute, which tells the game to execute thebinding code twice: once when the key is pressed down, and again whenthe key is released. The code sample shows that WoW provides a keystate