Package org.apache.jorphan.gui
Class JLabeledTextField
java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.JPanel
org.apache.jorphan.gui.JLabeledTextField
- All Implemented Interfaces:
FocusListener,ImageObserver,MenuContainer,Serializable,EventListener,Accessible,JLabeledField
- Direct Known Subclasses:
JLabeledPasswordField
A Helper component that wraps a JTextField with a label into a JPanel (this).
This component also has an efficient event handling mechanism for handling
the text changing in the Text Field. The registered change listeners are only
called when the text has changed.
- See Also:
-
Nested Class Summary
Nested classes/interfaces inherited from class javax.swing.JPanel
JPanel.AccessibleJPanelNested classes/interfaces inherited from class javax.swing.JComponent
JComponent.AccessibleJComponentNested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainerNested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy -
Field Summary
Fields inherited from class javax.swing.JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOWFields inherited from class java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENTFields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH -
Constructor Summary
ConstructorsConstructorDescriptionDefault constructor, The label and the Text field are left empty.JLabeledTextField(String pLabel) Constructs a new component with the label displaying the passed text.JLabeledTextField(String pLabel, int size) Constructs a new component with the label displaying the passed text.JLabeledTextField(String pLabel, int size, Color bk, boolean editable) Size defaults to 20JLabeledTextField(String pLabel, Color bk) Size defaults to 20 -
Method Summary
Modifier and TypeMethodDescriptionvoidaddChangeListener(ChangeListener pChangeListener) Adds a change listener, that will be notified when the text in the text field is changed.protected JTextFieldcreateTextField(int size) voidfocusGained(FocusEvent pFocusEvent) Catch what the value was when focus was gained.voidfocusLost(FocusEvent pFocusEvent) Callback method when the focus to the Text Field component is lost.Get the labelJLabelfollowed by the text field @linkJTextField.getLabel()Returns the text of the label.getText()Returns the text in the Text Field.Returns the tooltip string that has been set with setToolTipTextprotected voidNotify all registered change listeners that the text in the text field has changed.voidremoveChangeListener(ChangeListener pChangeListener) Removes a change listener.booleanvoidsetEnabled(boolean enable) voidSet the text displayed in the label.voidSet the text displayed in the Text Field.voidsetToolTipText(String text) Registers the text to display in a tool tip.Methods inherited from class javax.swing.JPanel
getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUIMethods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, updateMethods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTreeMethods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
-
Constructor Details
-
JLabeledTextField
public JLabeledTextField()Default constructor, The label and the Text field are left empty. -
JLabeledTextField
Constructs a new component with the label displaying the passed text.- Parameters:
pLabel- The text to in the label.
-
JLabeledTextField
Constructs a new component with the label displaying the passed text.- Parameters:
pLabel- The text to in the label.size- size of text field
-
JLabeledTextField
Size defaults to 20- Parameters:
pLabel- The text to in the label.bk-Colorbackground color
-
JLabeledTextField
Size defaults to 20- Parameters:
pLabel- The text to in the label.size- textfield lengthbk-Colorbackground color may be nulleditable- boolean
-
-
Method Details
-
getComponentList
Get the labelJLabelfollowed by the text field @linkJTextField.- Specified by:
getComponentListin interfaceJLabeledField
-
setEnabled
public void setEnabled(boolean enable) - Overrides:
setEnabledin classJComponent
-
createTextField
-
focusLost
Callback method when the focus to the Text Field component is lost.- Specified by:
focusLostin interfaceFocusListener- Parameters:
pFocusEvent- The focus event that occurred.
-
focusGained
Catch what the value was when focus was gained.- Specified by:
focusGainedin interfaceFocusListener
-
setLabel
Set the text displayed in the label.- Specified by:
setLabelin interfaceJLabeledField- Parameters:
pLabel- The new label text.
-
setText
Set the text displayed in the Text Field.- Specified by:
setTextin interfaceJLabeledField- Parameters:
pText- The new text to display in the text field.
-
getText
Returns the text in the Text Field.- Specified by:
getTextin interfaceJLabeledField- Returns:
- The text in the Text Field.
-
getLabel
Returns the text of the label.- Returns:
- The text of the label.
-
setToolTipText
Registers the text to display in a tool tip. The text displays when the cursor lingers over the component.- Overrides:
setToolTipTextin classJComponent- Parameters:
text- the string to display; if the text is null, the tool tip is turned off for this component
-
getToolTipText
Returns the tooltip string that has been set with setToolTipText- Overrides:
getToolTipTextin classJComponent- Returns:
- the text of the tool tip
-
addChangeListener
Adds a change listener, that will be notified when the text in the text field is changed. The ChangeEvent that will be passed to registered listeners will contain this object as the source, allowing the new text to be extracted using thegetTextmethod.- Specified by:
addChangeListenerin interfaceJLabeledField- Parameters:
pChangeListener- The listener to add
-
removeChangeListener
Removes a change listener.- Parameters:
pChangeListener- The change listener to remove.
-
notifyChangeListeners
protected void notifyChangeListeners()Notify all registered change listeners that the text in the text field has changed. -
requestFocusInWindow
public boolean requestFocusInWindow()- Overrides:
requestFocusInWindowin classJComponent
-