org.gnu.gtk.event

Class KeyEvent

public class KeyEvent extends GtkEvent

This event object is used to identify when a key has been pressed and released. In particular, it allows you to get at which key was pressed - see getKeyval.

See Also: An example of how to listen for KeyEvents KeyValue

Nested Class Summary
static classKeyEvent.Type
Constructor Summary
KeyEvent(Object source, KeyEvent.Type type, EventKey gdkEvent)
Construct a KeyEvent object.
Method Summary
intgetKeyval()
Returns the key value.
intgetLength()
Returns the length of the String that resulted from this keypress (see getString).
ModifierTypegetModifierKey()
Returns the modifier key used.
StringgetString()
Get the "null-terminated multi-byte string containing the composed characters resulting from the key press".
booleanisOfType(KeyEvent.Type test)
Test to compare events.

Constructor Detail

KeyEvent

public KeyEvent(Object source, KeyEvent.Type type, EventKey gdkEvent)
Construct a KeyEvent object.

Method Detail

getKeyval

public int getKeyval()
Returns the key value. Example:
       if (key == KeyValue.Return) {
           ...
       }
 

Returns: an int, the key value. See KeyValue for the comprehensive list of values.

getLength

public int getLength()
Returns the length of the String that resulted from this keypress (see getString).

Returns: int

getModifierKey

public ModifierType getModifierKey()
Returns the modifier key used.

Returns: (see ModifierType)

getString

public String getString()
Get the "null-terminated multi-byte string containing the composed characters resulting from the key press".

FIXME: Isn't null termination hidden in Java? And, in any case, characters in Strings in Java are multi-byte. So does this work right nor not?

Returns: String the character(s) resulting from the key press.

isOfType

public boolean isOfType(KeyEvent.Type test)
Test to compare events.