charvax.swing
Class ActionMap
- Serializable
public class ActionMap
extends java.lang.Object
implements Serializable
ActionMap
provides mappings from
Object
s
(called
keys or
Action
names)
to
Action
s.
An
ActionMap
is usually used with an
InputMap
to locate a particular action
when a key is pressed. As with
InputMap
,
an
ActionMap
can have a parent
that is searched for keys not defined in the
ActionMap
.
As with
InputMap
if you create a cycle, eg:
ActionMap am = new ActionMap();
ActionMap bm = new ActionMap():
am.setParent(bm);
bm.setParent(am);
some of the methods will cause a StackOverflowError to be thrown.
ActionMap() - Creates an
ActionMap with no parent and no mappings.
|
Object[] | allKeys() - Returns an array of the keys defined in this
ActionMap and
its parent.
|
void | clear() - Removes all the mappings from this
ActionMap .
|
Action | get(Object key) - Returns the binding for
key , messaging the
parent ActionMap if the binding is not locally defined.
|
ActionMap | getParent() - Returns this
ActionMap 's parent.
|
Object[] | keys() - Returns the
Action names that are bound in this ActionMap .
|
void | put(Object key, Action action) - Adds a binding for
key to action .
|
void | remove(Object key) - Removes the binding for
key from this ActionMap .
|
void | setParent(ActionMap map) - Sets this
ActionMap 's parent.
|
int | size() - Returns the number of
KeyStroke bindings.
|
ActionMap
public ActionMap()
Creates an ActionMap
with no parent and no mappings.
allKeys
public Object[] allKeys()
Returns an array of the keys defined in this ActionMap
and
its parent. This method differs from keys()
in that
this method includes the keys defined in the parent.
clear
public void clear()
Removes all the mappings from this ActionMap
.
get
public Action get(Object key)
Returns the binding for key
, messaging the
parent ActionMap
if the binding is not locally defined.
getParent
public ActionMap getParent()
Returns this ActionMap
's parent.
- the
ActionMap
that is the parent of this one,
or null if this ActionMap
has no parent
keys
public Object[] keys()
Returns the Action
names that are bound in this ActionMap
.
put
public void put(Object key,
Action action)
Adds a binding for
key
to
action
.
If
action
is null, this removes the current binding
for
key
.
In most instances,
key
will be
action.getValue(NAME)
.
remove
public void remove(Object key)
Removes the binding for key
from this ActionMap
.
setParent
public void setParent(ActionMap map)
Sets this ActionMap
's parent.
map
- the ActionMap
that is the parent of this one
size
public int size()
Returns the number of KeyStroke
bindings.