java.awt

Class MenuShortcut [ source ]

java.lang.Object

java.awt.MenuShortcut

All Implemented Interfaces:

Serializable

public class MenuShortcut
extends Object
implements Serializable

The MenuShortcutclass represents a keyboard accelerator for a MenuItem.

Menu shortcuts are created using virtual keycodes, not characters. For example, a menu shortcut for Ctrl-a (assuming that Control is the accelerator key) would be created with code like the following:

MenuShortcut ms = new MenuShortcut(KeyEvent.VK_A, false);

The accelerator key is platform-dependent and may be obtained via Toolkit.getMenuShortcutKeyMask().

Since:

JDK1.1

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
(package private) int	key The virtual keycode for the menu shortcut.
(package private) boolean	usesShift Indicates whether the shft key was pressed.

Constructor Summary

Constructors

Constructor and Description
MenuShortcut(int key) Constructs a new MenuShortcut for the specified virtual keycode.
MenuShortcut(int key, boolean useShiftModifier) Constructs a new MenuShortcut for the specified virtual keycode.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(MenuShortcut s) Returns whether this MenuShortcut is the same as another: equality is defined to mean that both MenuShortcuts use the same key and both either use or don't use the SHIFT key.
boolean	equals(Object obj) Returns whether this MenuShortcut is the same as another: equality is defined to mean that both MenuShortcuts use the same key and both either use or don't use the SHIFT key.
int	getKey() Returns the raw keycode of this MenuShortcut.
int	hashCode() Returns the hashcode for this MenuShortcut.
protected String	paramString() Returns the parameter string representing the state of this MenuShortcut.
String	toString() Returns an internationalized description of the MenuShortcut.
boolean	usesShiftModifier() Returns whether this MenuShortcut must be invoked using the SHIFT key.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

key

int key

The virtual keycode for the menu shortcut. This is the keycode with which the menu shortcut will be created. Note that it is a virtual keycode, not a character, e.g. KeyEvent.VK_A, not 'a'. Note: in 1.1.x you must use setActionCommand() on a menu item in order for its shortcut to work, otherwise it will fire a null action command.

Since:

JDK1.1

See Also:

getKey(), usesShiftModifier(), KeyEvent

usesShift

boolean usesShift

Indicates whether the shft key was pressed. If true, the shift key was pressed. If false, the shift key was not pressed

Since:

JDK1.1

See Also:

usesShiftModifier()

Constructor Detail

MenuShortcut

public MenuShortcut(int key)

Constructs a new MenuShortcut for the specified virtual keycode.

Parameters:

key - the raw keycode for this MenuShortcut, as would be returned in the keyCode field of a KeyEvent if this key were pressed.

See Also:

KeyEvent

MenuShortcut

public MenuShortcut(int key,
            boolean useShiftModifier)

Constructs a new MenuShortcut for the specified virtual keycode.

Parameters:

key - the raw keycode for this MenuShortcut, as would be returned in the keyCode field of a KeyEvent if this key were pressed.

useShiftModifier - indicates whether this MenuShortcut is invoked with the SHIFT key down.

See Also:

KeyEvent

Method Detail

getKey

public int getKey()

Returns the raw keycode of this MenuShortcut.

Returns:

the raw keycode of this MenuShortcut.

Since:

JDK1.1

See Also:

KeyEvent

usesShiftModifier

public boolean usesShiftModifier()

Returns whether this MenuShortcut must be invoked using the SHIFT key.

Returns:

true if this MenuShortcut must be invoked using the SHIFT key, false otherwise.

Since:

JDK1.1

equals

public boolean equals(MenuShortcut s)

Returns whether this MenuShortcut is the same as another: equality is defined to mean that both MenuShortcuts use the same key and both either use or don't use the SHIFT key.

Parameters:

s - the MenuShortcut to compare with this.

Returns:

true if this MenuShortcut is the same as another, false otherwise.

Since:

JDK1.1

equals

public boolean equals(Object obj)

Returns whether this MenuShortcut is the same as another: equality is defined to mean that both MenuShortcuts use the same key and both either use or don't use the SHIFT key.

Overrides:

equals in class Object

Parameters:

obj - the Object to compare with this.

Returns:

true if this MenuShortcut is the same as another, false otherwise.

Since:

1.2

See Also:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

Returns the hashcode for this MenuShortcut.

Overrides:

hashCode in class Object

Returns:

the hashcode for this MenuShortcut.

Since:

1.2

See Also:

Object.equals(java.lang.Object), Hashtable

toString

public String toString()

Returns an internationalized description of the MenuShortcut.

Overrides:

toString in class Object

Returns:

a string representation of this MenuShortcut.

Since:

JDK1.1

paramString

protected String paramString()

Returns the parameter string representing the state of this MenuShortcut. This string is useful for debugging.

Returns:

the parameter string of this MenuShortcut.

Since:

JDK1.1