java.lang.Object
javax.swing.ActionMap
- All Implemented Interfaces:
Serializable
- Direct Known Subclasses:
ActionMapUIResource
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.
- Since:
- 1.3
- See Also:
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionObject[]
allKeys()
Returns an array of the keys defined in thisActionMap
and its parent.void
clear()
Removes all the mappings from thisActionMap
.Returns the binding forkey
, messaging the parentActionMap
if the binding is not locally defined.Returns thisActionMap
's parent.Object[]
keys()
Returns theAction
names that are bound in thisActionMap
.void
Adds a binding forkey
toaction
.void
Removes the binding forkey
from thisActionMap
.void
Sets thisActionMap
's parent.int
size()
Returns the number of bindings in thisActionMap
.
-
Constructor Details
-
ActionMap
public ActionMap()Creates anActionMap
with no parent and no mappings.
-
-
Method Details
-
setParent
Sets thisActionMap
's parent.- Parameters:
map
- theActionMap
that is the parent of this one
-
getParent
Returns thisActionMap
's parent.- Returns:
- the
ActionMap
that is the parent of this one, or null if thisActionMap
has no parent
-
put
Adds a binding forkey
toaction
. Ifaction
is null, this removes the current binding forkey
.In most instances,
key
will beaction.getValue(NAME)
.- Parameters:
key
- a keyaction
- a binding forkey
-
get
Returns the binding forkey
, messaging the parentActionMap
if the binding is not locally defined.- Parameters:
key
- a key- Returns:
- the binding for
key
-
remove
Removes the binding forkey
from thisActionMap
.- Parameters:
key
- a key
-
clear
public void clear()Removes all the mappings from thisActionMap
. -
keys
Returns theAction
names that are bound in thisActionMap
.- Returns:
- an array of the keys
-
size
public int size()Returns the number of bindings in thisActionMap
.- Returns:
- the number of bindings in this
ActionMap
-
allKeys
Returns an array of the keys defined in thisActionMap
and its parent. This method differs fromkeys()
in that this method includes the keys defined in the parent.- Returns:
- an array of the keys
-