/*
* @(#)Keymap.java 1.18 03/12/19
*
* Copyright 2004 Sun Microsystems, Inc. All rights reserved.
* SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
*/
package javax.swing.text;
import javax.swing.Action;
import javax.swing.KeyStroke;
/**
* A collection of bindings of KeyStrokes to actions. The
* bindings are basically name-value pairs that potentially
* resolve in a hierarchy.
*
* @author Timothy Prinzing
* @version 1.18 12/19/03
*/
public interface Keymap {
/**
* Fetches the name of the set of key-bindings.
*
* @return the name
*/
public String getName();
/**
* Fetches the default action to fire if a
* key is typed (i.e. a KEY_TYPED KeyEvent is received)
* and there is no binding for it. Typically this
* would be some action that inserts text so that
* the keymap doesn't require an action for each
* possible key.
*
* @return the default action
*/
public Action getDefaultAction();
/**
* Set the default action to fire if a key is typed.
*
* @param a the action
*/
public void setDefaultAction(Action a);
/**
* Fetches the action appropriate for the given symbolic
* event sequence. This is used by JTextController to
* determine how to interpret key sequences. If the
* binding is not resolved locally, an attempt is made
* to resolve through the parent keymap, if one is set.
*
* @param key the key sequence
* @return the action associated with the key
* sequence if one is defined, otherwise <code>null</code>
*/
public Action getAction(KeyStroke key);
/**
* Fetches all of the keystrokes in this map that
* are bound to some action.
*
* @return the list of keystrokes
*/
public KeyStroke[] getBoundKeyStrokes();
/**
* Fetches all of the actions defined in this keymap.
*
* @return the list of actions
*/
public Action[] getBoundActions();
/**
* Fetches the keystrokes that will result in
* the given action.
*
* @param a the action
* @return the list of keystrokes
*/
public KeyStroke[] getKeyStrokesForAction(Action a);
/**
* Determines if the given key sequence is locally defined.
*
* @param key the key sequence
* @return true if the key sequence is locally defined else false
*/
public boolean isLocallyDefined(KeyStroke key);
/**
* Adds a binding to the keymap.
*
* @param key the key sequence
* @param a the action
*/
public void addActionForKeyStroke(KeyStroke key, Action a);
/**
* Removes a binding from the keymap.
*
* @param keys the key sequence
*/
public void removeKeyStrokeBinding(KeyStroke keys);
/**
* Removes all bindings from the keymap.
*/
public void removeBindings();
/**
* Fetches the parent keymap used to resolve key-bindings.
*
* @return the keymap
*/
public Keymap getResolveParent();
/**
* Sets the parent keymap, which will be used to
* resolve key-bindings.
*
* @param parent the parent keymap
*/
public void setResolveParent(Keymap parent);
}
|