WoW:UIHANDLER OnKeyDown: Difference between revisions
(initial content now that I know it sort of works) |
mNo edit summary |
||
| Line 4: | Line 4: | ||
The OnKeyDown handler is called when the user first hits a key and this frame is registered for keyboard events with [[API Frame EnableKeyboard|Frame:EnableKeyboard]]. See also [[UIHANDLER OnKeyUp|OnKeyUp]]. | The OnKeyDown handler is called when the user first hits a key and this frame is registered for keyboard events with [[API Frame EnableKeyboard|Frame:EnableKeyboard]]. See also [[UIHANDLER OnKeyUp|OnKeyUp]]. | ||
It should also be noted that the [[frameStrata]] has to be at least DIALOG or higher for this to work. | |||
Note that if you think you want to use this handler to take an in-game action based on a keypress, you probably really want to enable the <code>runOnUp</code> attribute of a key binding, and check the <code>keystate</code> variable and act accordingly. See [[HOWTO: Use Bindings.xml to create key bindings for your AddOn]]. This handler is more appropriate for cases where you want to allow freeform text entry and an [[UIOBJECT EditBox|EditBox]] isn't flexible enough. | Note that if you think you want to use this handler to take an in-game action based on a keypress, you probably really want to enable the <code>runOnUp</code> attribute of a key binding, and check the <code>keystate</code> variable and act accordingly. See [[HOWTO: Use Bindings.xml to create key bindings for your AddOn]]. This handler is more appropriate for cases where you want to allow freeform text entry and an [[UIOBJECT EditBox|EditBox]] isn't flexible enough. | ||
Revision as of 00:44, 8 October 2006
Description
The OnKeyDown handler is called when the user first hits a key and this frame is registered for keyboard events with Frame:EnableKeyboard. See also OnKeyUp.
It should also be noted that the frameStrata has to be at least DIALOG or higher for this to work.
Note that if you think you want to use this handler to take an in-game action based on a keypress, you probably really want to enable the runOnUp attribute of a key binding, and check the keystate variable and act accordingly. See HOWTO: Use Bindings.xml to create key bindings for your AddOn. This handler is more appropriate for cases where you want to allow freeform text entry and an EditBox isn't flexible enough.
Arguments
arg1 - returned as a string representing the key that was pressed. For example, "W" or "A" or "S" or "D" (main keyboard keys) or "UP" or "LEFT" or "DOWN" or "RIGHT" (arrow keys) or "DELETE" or other extended keys or "SHIFT" or other modifier keys.