javax.swing

Class InputMap

Implemented Interfaces:
Serializable
Known Direct Subclasses:
ComponentInputMap, InputMapUIResource

public class InputMap
extends Object
implements Serializable

Maps KeyStrokes to arbitrary objects, usually Strings. This is used in combination with ActionMaps. If a component receives an input event, this is looked up in the component's InputMap. The result is an object which serves as a key to the components ActionMap. Finally the Action that is stored is executed.
Since:
1.3
See Also:
Serialized Form

Constructor Summary

InputMap()
Creates a new InputMap instance.

Method Summary

KeyStroke[]
allKeys()
Returns all keys of entries in this InputMap and all its parents.
void
clear()
Clears the InputMap.
Object
get(KeyStroke keystroke)
Returns the binding for keystroke.
InputMap
getParent()
Returns the parent of this InputMap.
KeyStroke[]
keys()
Returns all keys of entries in this InputMap.
void
put(KeyStroke keystroke, Object actionMapKey)
Puts a new entry into the InputMap.
void
remove(KeyStroke keystroke)
Remove an entry from the InputMap.
void
setParent(InputMap parentMap)
Sets a parent for this InputMap.
int
size()
Returns the number of entries in this InputMap.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

InputMap

public InputMap()
Creates a new InputMap instance.

Method Details

allKeys

public KeyStroke[] allKeys()
Returns all keys of entries in this InputMap and all its parents.
Returns:
an array of keys

clear

public void clear()
Clears the InputMap.

get

public Object get(KeyStroke keystroke)
Returns the binding for keystroke.
Parameters:
keystroke - the key of the enty
Returns:
the binding associated with keystroke may be null

getParent

public InputMap getParent()
Returns the parent of this InputMap.
Returns:
the parent, may be null.

keys

public KeyStroke[] keys()
Returns all keys of entries in this InputMap.
Returns:
an array of keys

put

public void put(KeyStroke keystroke,
                Object actionMapKey)
Puts a new entry into the InputMap. If actionMapKey is null an existing entry will be removed.
Parameters:
keystroke - the keystroke for the entry
actionMapKey - the action.

remove

public void remove(KeyStroke keystroke)
Remove an entry from the InputMap.
Parameters:
keystroke - the key of the entry to remove

setParent

public void setParent(InputMap parentMap)
Sets a parent for this InputMap.
Parameters:
parentMap - the new parent

size

public int size()
Returns the number of entries in this InputMap.
Returns:
the number of entries

InputMap.java -- Copyright (C) 2002, 2004 Free Software Foundation, Inc. This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.