Difference between revisions of "Keyboard (Chili Framework)"
(→Event) |
|||
| Line 25: | Line 25: | ||
=== IsPress === | === IsPress === | ||
| − | <code>bool Keyboard::IsPress() const</code><br /> | + | <code>bool Keyboard::Event::IsPress() const</code><br /> |
Returns <code>true</code> if the event is a press event. | Returns <code>true</code> if the event is a press event. | ||
=== IsRelease === | === IsRelease === | ||
| − | <code>bool Keyboard::IsRelease() const</code><br /> | + | <code>bool Keyboard::Event::IsRelease() const</code><br /> |
Returns <code>true</code> if the event is a release event. | Returns <code>true</code> if the event is a release event. | ||
=== IsValid === | === IsValid === | ||
| − | <code>bool Keyboard::IsValid() const</code><br /> | + | <code>bool Keyboard::Event::IsValid() const</code><br /> |
Returns <code>true</code> if the event is a valid event (reading from an empty buffer will return an invalid event object). | Returns <code>true</code> if the event is a valid event (reading from an empty buffer will return an invalid event object). | ||
=== GetCode === | === GetCode === | ||
| − | <code>char Keyboard::GetCode()</code><br /> | + | <code>char Keyboard::Event::GetCode()</code><br /> |
Gets the virtual key code of the key associated with the <code>Event</code> object. | Gets the virtual key code of the key associated with the <code>Event</code> object. | ||
Revision as of 21:09, 13 July 2016
With Keyboard, you can get the current state of depressed keys, and you can pop key press and release events out of an Event queue contained in Keyboard. You can also turn autorepeat on/off. Whopee. (Note: the kbd object lives in MainWindow's belly.)
Contents
Members
KeyIsPressed
bool Keyboard::KeyIsPressed( unsigned char keycode ) const
Checks to see if a specific key is currently in the pressed state. The function parameter is the virtual key code of the key that you want to check.
ReadKey
Event Keyboard::ReadKey()
Pull a fresh Event object out of the key press/release event queue. Erases an event from the queue and returns a copy if there is a key press event in the queue. Returns an invalid Event object if the queue is empty.
KeyIsEmpty
bool Keyboard::KeyIsEmpty() const
Check to see if the key event queue is empty.
Event
class Keyboard::Event
Key press and release events are held in a queue in Keyboard in the order they occurred. These events are modeled with their own class because they're precious fucking little snowflakes. You pull them out of the buffer with Keyboard::ReadKey().
Type
enum Keyboard::Event::Type
This represents the different types of events that can be recorded. The options are Press, Release, and Invalid.
IsPress
bool Keyboard::Event::IsPress() const
Returns true if the event is a press event.
IsRelease
bool Keyboard::Event::IsRelease() const
Returns true if the event is a release event.
IsValid
bool Keyboard::Event::IsValid() const
Returns true if the event is a valid event (reading from an empty buffer will return an invalid event object).
GetCode
char Keyboard::Event::GetCode()
Gets the virtual key code of the key associated with the Event object.
Virtual Key Codes
The virtual key code for a standard alphanumeric key is just the char literal (capital if alphabetic), e.g. 'A' or '9'. Virtual key codes for other keys are defined with #define macros somewhere in Windows.h (or more likely in one of the headers that it includes). Some common ones are:
-
VK_SPACE -
VK_SHIFT -
VK_ENTER -
VK_ESCAPE
See also
- The Chili Framework
