qflib 0.98.1

de.qfs.lib.option
Class KeyOptionEdit

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent
                    |
                    +--javax.swing.JPanel
                          |
                          +--de.qfs.lib.option.OptionEdit
                                |
                                +--de.qfs.lib.option.KeyOptionEdit
All Implemented Interfaces:
javax.accessibility.Accessible, java.util.EventListener, java.awt.image.ImageObserver, java.awt.event.KeyListener, java.awt.MenuContainer, java.io.Serializable

public class KeyOptionEdit
extends OptionEdit
implements java.awt.event.KeyListener

Edit for a KeyOption, built from a JLabel and a custom component. It uses the following resources:

Resource name Usage
option.name.label The label for the Option (optional, default empty).
option.name.internal If true, place the label inside the component (optional, default false).
option.name.mnemonic Keyboard accelerator (optional, default none).
option.name.disabled If true, the edit will be disabled and remain so even if setEnabled(true) is called (optional, default false).
option.name.capturetab If true the tab key is accepted as input and cannot be used to focus the next component (optional, default false).

Since:
0.98.1
Version:
$Revision: 1.4 $
Author:
Gregor Schmid
See Also:
Serialized Form

Inner Class Summary
protected static class KeyOptionEdit.KeyLabel
          Extended Label that displays a key combination.
 
Inner classes inherited from class javax.swing.JPanel
javax.swing.JPanel.AccessibleJPanel
 
Inner classes inherited from class javax.swing.JComponent
javax.swing.JComponent.AccessibleJComponent
 
Inner classes inherited from class java.awt.Container
java.awt.Container.AccessibleAWTContainer
 
Inner classes inherited from class java.awt.Component
java.awt.Component.AccessibleAWTComponent
 
Field Summary
protected  java.lang.String ilabel
           
protected  KeyOptionEdit.KeyLabel key
          The custom component.
protected  char keyChar
          The current keyChar value.
protected  int keyCode
          The current keyCode value.
protected  javax.swing.JLabel label
          The label of the component.
protected  java.util.Vector listeners
          The registered ChangeListeners.
protected  int modifiers
          The current modifiers value.
 
Fields inherited from class de.qfs.lib.option.OptionEdit
disabled, group, option
 
Fields inherited from class javax.swing.JComponent
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
 
Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
Constructor Summary
KeyOptionEdit()
          Create a new KeyOptionEdit.
 
Method Summary
 void addChangeListener(javax.swing.event.ChangeListener listener)
          Add a ChangeListener to the KeyOptionEdit.
 boolean checkValue()
          Check the currently entered value of the OptionEdit.
protected  void fireChanged()
          Notify the listeners that the key combination has changed.
 char getKeyChar()
          Get the current keyChar value.
 int getKeyCode()
          Get the current keyCode value.
 int getModifiers()
          Get the current modifiers value.
 void init()
          Initialize the OptionEdit.
 boolean isEnabled()
          Query whether the KeyOptionEdit is enabled.
 void keyPressed(java.awt.event.KeyEvent e)
          Notify the listener that a key was pressed.
 void keyReleased(java.awt.event.KeyEvent e)
          Notify the listener that a key was released.
 void keyTyped(java.awt.event.KeyEvent e)
          Notify the listener that a key was typed.
 void readValue()
          Read the currently entered value and store it in the Option.
 void removeChangeListener(javax.swing.event.ChangeListener listener)
          Remove a ChangeListener from the KeyOptionEdit.
 void requestFocus()
          Request the focus for the KeyOptionEdit.
 void setEnabled(boolean enabled)
          Enable or disable the KeyOptionEdit.
 void update(Option option)
          Update the display for a possibly new Option.
 
Methods inherited from class de.qfs.lib.option.OptionEdit
addPackage, getBoolean, getInt, getOption, getOptionGroup, getString, getWeight, isDisabled, makeEdit, setDisabled, setOptionGroup, update
 
Methods inherited from class javax.swing.JPanel
getAccessibleContext, getUIClassID, paramString, updateUI
 
Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getVerifyInputWhenFocusTarget, getVisibleRect, getWidth, getX, getY, grabFocus, hasFocus, hide, isDoubleBuffered, isFocusCycleRoot, isFocusTraversable, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processFocusEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDoubleBuffered, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
 
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getLayout, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setLayout, validate, validateTree
 
Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getInputContext, getInputMethodRequests, getLocale, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, imageUpdate, inside, isDisplayable, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

label

protected javax.swing.JLabel label
The label of the component.

ilabel

protected java.lang.String ilabel

key

protected KeyOptionEdit.KeyLabel key
The custom component.

keyCode

protected int keyCode
The current keyCode value.

keyChar

protected char keyChar
The current keyChar value.

modifiers

protected int modifiers
The current modifiers value.

listeners

protected java.util.Vector listeners
The registered ChangeListeners.
Constructor Detail

KeyOptionEdit

public KeyOptionEdit()
Create a new KeyOptionEdit. Don't call this directly, use OptionEdit.makeEdit.
Method Detail

init

public void init()
Initialize the OptionEdit. Called from makeEdit.
Overrides:
init in class OptionEdit

checkValue

public boolean checkValue()
Check the currently entered value of the OptionEdit. If the value is not valid, request the focus.
Overrides:
checkValue in class OptionEdit
Returns:
True if the value is valid, false otherwise.

readValue

public void readValue()
Read the currently entered value and store it in the Option.
Overrides:
readValue in class OptionEdit

update

public void update(Option option)
Update the display for a possibly new Option.
Overrides:
update in class OptionEdit
Parameters:
option - The new option.

setEnabled

public void setEnabled(boolean enabled)
Enable or disable the KeyOptionEdit.
Overrides:
setEnabled in class javax.swing.JComponent
Parameters:
enabled - True to enable, false to disable.

isEnabled

public boolean isEnabled()
Query whether the KeyOptionEdit is enabled.
Overrides:
isEnabled in class java.awt.Component
Returns:
True if it is enabled.

requestFocus

public void requestFocus()
Request the focus for the KeyOptionEdit.
Overrides:
requestFocus in class javax.swing.JComponent

addChangeListener

public void addChangeListener(javax.swing.event.ChangeListener listener)
Add a ChangeListener to the KeyOptionEdit. It will be notified when the selected key combination changes.
Parameters:
listener - The listener to add.

removeChangeListener

public void removeChangeListener(javax.swing.event.ChangeListener listener)
Remove a ChangeListener from the KeyOptionEdit.
Parameters:
listener - The listener to remove.

fireChanged

protected void fireChanged()
Notify the listeners that the key combination has changed.

getKeyCode

public int getKeyCode()
Get the current keyCode value.
Returns:
The current keyCode value.

getKeyChar

public char getKeyChar()
Get the current keyChar value.
Returns:
The current keyChar value.

getModifiers

public int getModifiers()
Get the current modifiers value.
Returns:
The current modifiers value.

keyPressed

public void keyPressed(java.awt.event.KeyEvent e)
Notify the listener that a key was pressed.
Specified by:
keyPressed in interface java.awt.event.KeyListener
Parameters:
e - The event containing the details.

keyTyped

public void keyTyped(java.awt.event.KeyEvent e)
Notify the listener that a key was typed. Noop.
Specified by:
keyTyped in interface java.awt.event.KeyListener
Parameters:
e - The event containing the details.

keyReleased

public void keyReleased(java.awt.event.KeyEvent e)
Notify the listener that a key was released. Noop.
Specified by:
keyReleased in interface java.awt.event.KeyListener
Parameters:
e - The event containing the details.

qflib 0.98.1