org.gnu.gtk.event

Interface KeyListener

public interface KeyListener

Deprecated: This class is part of the java-gnome 2.x family of libraries, which, due to their inefficiency and complexity, are no longer being maintained and have been abandoned by the java-gnome project. Signal handling an connection has been completely re-implemented in java-gnome 4.0, so you will need to refactor any code attempting to use signals. In particular, Listener interfaces and Event classes have been collapsed to a single interface in the new design.

This is the listener interface for receiving keyboard events on a Widget. Objects that are interested in keyboard events should implement this Interface and then register with the Widget using the addListener method.

An example of using this to trap the Escape key:

  Window window;
  ...
  window.addListener(new KeyListener() {
       public boolean keyEvent(KeyEvent event) {
      		int key = event.getKeyval();
      		if (key == KeyValue.Escape) {
      			window.hide();
      			return true;
      		} else {
      			return false;
      		}
      	}
  });
 

See Also: KeyEvent The list of KeyEvent types

Method Summary
booleankeyEvent(KeyEvent event)
Process a keystroke.

Method Detail

keyEvent

public boolean keyEvent(KeyEvent event)

Deprecated: Superceeded by java-gnome 4.0; this method or constant will no doubt exist conceptually, but it may have a different name or signature in order that the project API is an algorithmic mapping of the underlying native libraries.

Process a keystroke.

Parameters: event gives you access to the various methods which help you identify the keystroke. See getKeyval

Returns: Return true if you have handled the keystroke and do not want it to propagate to the default GTK handlers. Returning false will allow the keystroke to go upstream after you're done doing whatever you're doing.