WoW:UIHANDLER OnKeyUp: Difference between revisions
(fixed typo) |
mNo edit summary |
||
| Line 4: | Line 4: | ||
The OnKeyUp handler is called when the user releases a key and this frame is registered for keyboard events with [[API Frame EnableKeyboard|Frame:EnableKeyboard]]. See also [[UIHANDLER OnKeyDown|OnKeyDown]]. | The OnKeyUp handler is called when the user releases a key and this frame is registered for keyboard events with [[API Frame EnableKeyboard|Frame:EnableKeyboard]]. See also [[UIHANDLER OnKeyDown|OnKeyDown]]. | ||
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:43, 8 October 2006
Description
The OnKeyUp handler is called when the user releases a key and this frame is registered for keyboard events with Frame:EnableKeyboard. See also OnKeyDown.
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 released. 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.