de.ipcon.form

Class FText

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

de.ipcon.swing.IPanel

de.ipcon.form.FPanel

de.ipcon.form.FInputPanel

de.ipcon.form.FTextInputComponent

de.ipcon.form.FText

All Implemented Interfaces:

AsyncRefreshExecutorI, FormElementI, FormElementWithDisplayPropertyI, FormInputPanelMandatoryI, InitialFocusCandidateI, de.ipcon.swing.FocusVetoHandlerI, java.awt.event.FocusListener, java.awt.event.KeyListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.util.EventListener, javax.accessibility.Accessible, javax.swing.event.DocumentListener, javax.swing.Scrollable

Direct Known Subclasses:

FEmail, FUri

public class FText
extends FTextInputComponent
implements java.awt.event.KeyListener, FormElementWithDisplayPropertyI

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.BaselineResizeBehavior

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.LinkedHashMap	myActions
static java.util.HashMap	myAttributes
static java.util.HashMap	myElements

Fields inherited from class de.ipcon.form.FPanel

XMLConfigureInfo

Fields inherited from class de.ipcon.swing.IPanel

inhibitFocusChange, SCROLLING_MODE_ANY, SCROLLING_MODE_HORIZONTAL_ONLY, SCROLLING_MODE_VERTICAL_ONLY, TEXTURE_CENTERED, TEXTURE_REPEAT

Fields inherited from class javax.swing.JComponent

TOOL_TIP_TEXT_KEY, 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 de.ipcon.form.FormElementI

ALL_ACTIONS, AVAILABLE_ACTION_KIND, CONTEXTMENU_ACTION_KIND, LOCAL_ACTION_KIND, MENU_ACTION_KIND, NO_LOCAL_ACTION_KIND, NO_TOPMDI_ONLY_ACTION_KIND, NOT_AVAILABLE_ACTION_KIND, REFRESH_FROM_TRANSACTION, REFRESH_FROM_USER, SHORTCUT_ACTION_KIND, TOOLBAR_ACTION_KIND, TOPMDI_ONLY_ACTION_KIND

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor and Description
FText(FormContextI _ftx, electric.xml.Element _confroot)
FText(FormContextI _ftx, electric.xml.Element _confroot, boolean _skipBuilding)

Method Summary

Modifier and Type	Method and Description
void	buildGUI()
java.lang.Object	calculateDisplayValue(AsyncRefreshRequestI r) Calculates a display value for an asynchronous refresh request.
void	close()
java.util.HashMap	getAttributeMap() Returns the map of attributes supported by this component.
java.util.LinkedHashMap	getDefaultActionMap() Returns the default action map for this component.
java.lang.String	getDisplayProperty()
java.lang.String	getDisplayValue(AttributeI att, BO bo)
java.util.HashMap	getElementMap() Returns the map of elements supported by this component.
javax.swing.JComponent	getJComponent() Returns the "JComponent" associated with this form element.
javax.swing.text.JTextComponent	getTextComponent()
void	handleClassA(electric.xml.Attribute a)
void	handleDisabledA(electric.xml.Attribute a)
void	handleDisplayFormatA(electric.xml.Attribute a)
void	handleDisplayPropertyA(electric.xml.Attribute a)
void	handleFontA(electric.xml.Attribute a)
void	handleForegroundA(electric.xml.Attribute a)
void	handleFormatA(electric.xml.Attribute a)
void	handleInputFormatE(electric.xml.Element e)
void	handleLineWrapA(electric.xml.Attribute a)
void	handlePasswordA(electric.xml.Attribute a)
void	handleRoundingFormatA(electric.xml.Attribute a)
void	handleRowsA(electric.xml.Attribute a)
void	handleSyncOnWaitA(electric.xml.Attribute a)
void	handleSyncOnWaitDelayA(electric.xml.Attribute a)
void	handleTabSizeA(electric.xml.Attribute a)
void	handleTranslationAvailableA(electric.xml.Attribute a)
void	handleWrapStyleWordA(electric.xml.Attribute a)
void	keyPressed(java.awt.event.KeyEvent e)
void	keyReleased(java.awt.event.KeyEvent e)
void	keyTyped(java.awt.event.KeyEvent e)
void	lockDisplayValue() Locks the UI component that displays the value to prevent concurrent inputs during async refresh operations.
void	registerActionImpl(FormAction a)
void	renderDisplayValue(AsyncRefreshRequestI r, java.lang.Object displayValue) Renders the calculated value on the UI.
void	restoreLockstateOfDisplayValue() Unlocks the UI component that displays the value again.
void	setBOValue(AttributeI att, BO bo, java.lang.String dt)
void	syncImpl()
void	updateIconPanel()

Methods inherited from class de.ipcon.form.FTextInputComponent

_setText, changedUpdate, disable, enable, focusGained, focusLost, getAlign, getBaseline, getColumns, getExplicitNullProperty, getFallbackProperty, getFontSize, getFontStyle, getInitialFocus, getProperty, getSelectedText, getSelectionEnd, getSelectionStart, getText, handleAlignA, handleAttributes, handleColumnsA, handleSelectAllWhenFocusedA, hasFocus, insertUpdate, isSelectAllWhenFocused, postRefresh, postRefresh, refresh, removeUpdate, requestFocusInWindow, selectAll, selectNone, setAlign, setColumns, setEditable, setEditable, setEnabled, setEnabled, setExplicitNullProperty, setFallbackProperty, setFontSize, setFontStyle, setProperty, setSelectAllWhenFocused, setText, setText, updateEditableStatus, updateEditableStatus

Methods inherited from class de.ipcon.form.FInputPanel

calculateMandatory, getAlsoMandatoryIf, handleAlsoMandatoryIfE

Methods inherited from class de.ipcon.form.FPanel

_refreshActions, action_editForm_available, action_editForm_enabled, action_editForm, action_refreshView_available, action_refreshView, action_reopenView_available, action_reopenView_enabled, action_reopenView, addBeanA, addFormElementListener, addHandleA, addHandleE, afterSave, afterSetValue, assureTransferHandler, beforeSave, beforeSetValue, calculationMightBeExpensive, callLog, cancelPendingRefreshRequests, checkEditable, checkVisible, evalScript, evalScript, evalScript, evalScript, evalScript, fhide, focusNextComponent, focusPreviousComponent, fshow, getActions, getActionsOfKind, getActionsOfKind, getBO, getConfRoot, getCtx, getDebugName, getFormActions, getFtx, getInstrumentedSchema, getLastRefreshRequest, getMaximumSize, getMinimumSize, getMissingPropertiesPolicy, getPreferredSize, getRefreshRequestsPending, getSchema, handleActionE, handleDropAllowedIfE, handleEditableA, handleEditableIfE, handleElement, handleElements, handleElements, handleElements, handleImpliedA, handleMaximumSizeA, handleMaxSizeA, handleMinimumSizeA, handleMinSizeA, handleMissingPropertiesPolicyA, handleNameA, handleNewElement, handleNewElement, handleNewElement, handleOnAfterSaveE, handleOnAfterSetValueE, handleOnBeforeSaveE, handleOnBeforeSetValueE, handleOnConstructionE, handleOnDropE, handleOnFocusGainedE, handleOnFocusLostE, handleOnMDIActivateE, handleOnMDICloseE, handleOnMDIDeactivateE, handleOnMDIOpenE, handleOnRefreshE, handleOnSyncE, handlePreferredSizeA, handlePrefSizeA, handleScriptE, handleVirtualPropertyE, handleVisibleIfE, hasPreferredSizeOverride, invokeAction, invokeAction, isClosed, isDebug, isDefinedEditable, isEditable, isExplicitEditable, isGUIBuilt, isImpliedElement, isInputPossible, isShown, mdiActivate, mdiClose, mdiDeactivate, mdiOpen, postConstructor, postInit, postRefresh, processFocusVeto, processFocusVeto, queueDelayedRefresh, queueDelayedRefresh, reallyHandleVirtualPropertyE, refresh, refreshActions, refreshActions, registerFormAction, removeFormElementListener, requestFocus, requestFocusInWindow, runAndDeclare, runAndDeclare, setConfRoot, setDebug, setFtx, setGUIBuilt, setMissingPropertiesPolicy, setShown, shouldShow, sync, waitForAsyncRefreshes, willCareForChildActions, willCareForChildRefresh

Methods inherited from class de.ipcon.swing.IPanel

getPreferredScrollableViewportSize, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, getScrollingMode, grabFocus, init, init, init, paintComponent, setScrollingMode, setTexture

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, firePropertyChange, firePropertyChange, firePropertyChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintImmediately, paintImmediately, print, printAll, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, 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, setToolTipText, setTransferHandler, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, 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, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, contains, createImage, createImage, createVolatileImage, createVolatileImage, dispatchEvent, enable, enableInputMethods, 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, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, 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, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface de.ipcon.form.FormElementI

addFormElementListener, afterSave, afterSetValue, beforeSave, beforeSetValue, getActions, getActionsOfKind, getConfRoot, getCtx, getDebugName, getFtx, getName, getSchema, handleAttributes, handleElement, handleElements, handleNewElement, isClosed, isDebug, isEditable, isGUIBuilt, isInputPossible, isShown, mdiActivate, mdiClose, mdiDeactivate, mdiOpen, postInit, postRefresh, refresh, refresh, removeFormElementListener, requestFocus, setEditable, sync, toDebugName, willCareForChildActions, willCareForChildRefresh

Field Detail

myAttributes

public static java.util.HashMap myAttributes

myElements

public static java.util.HashMap myElements

myActions

public static java.util.LinkedHashMap myActions

Constructor Detail

FText

public FText(FormContextI _ftx,
             electric.xml.Element _confroot)

FText

public FText(FormContextI _ftx,
             electric.xml.Element _confroot,
             boolean _skipBuilding)

Method Detail

getTextComponent

public javax.swing.text.JTextComponent getTextComponent()

Specified by:

getTextComponent in class FTextInputComponent

getJComponent

public javax.swing.JComponent getJComponent()

Description copied from class: FInputPanel

Returns the "JComponent" associated with this form element.

Overrides:

getJComponent in class FTextInputComponent

Returns:

The "JComponent" of this form element.

getDisplayProperty

public java.lang.String getDisplayProperty()

Specified by:

getDisplayProperty in interface FormElementWithDisplayPropertyI

close

public void close()

Specified by:

close in interface FormElementI

Overrides:

close in class FTextInputComponent

buildGUI

public void buildGUI()

registerActionImpl

public void registerActionImpl(FormAction a)

Overrides:

registerActionImpl in class FPanel

updateIconPanel

public void updateIconPanel()

handleDisabledA

public void handleDisabledA(electric.xml.Attribute a)

handlePasswordA

public void handlePasswordA(electric.xml.Attribute a)

handleLineWrapA

public void handleLineWrapA(electric.xml.Attribute a)

handleWrapStyleWordA

public void handleWrapStyleWordA(electric.xml.Attribute a)

handleFontA

public void handleFontA(electric.xml.Attribute a)

handleTabSizeA

public void handleTabSizeA(electric.xml.Attribute a)

handleClassA

public void handleClassA(electric.xml.Attribute a)

handleDisplayPropertyA

public void handleDisplayPropertyA(electric.xml.Attribute a)

handleRowsA

public void handleRowsA(electric.xml.Attribute a)

handleFormatA

public void handleFormatA(electric.xml.Attribute a)

handleDisplayFormatA

public void handleDisplayFormatA(electric.xml.Attribute a)

handleRoundingFormatA

public void handleRoundingFormatA(electric.xml.Attribute a)

handleForegroundA

public void handleForegroundA(electric.xml.Attribute a)

handleInputFormatE

public void handleInputFormatE(electric.xml.Element e)

handleSyncOnWaitA

public void handleSyncOnWaitA(electric.xml.Attribute a)

handleSyncOnWaitDelayA

public void handleSyncOnWaitDelayA(electric.xml.Attribute a)

handleTranslationAvailableA

public void handleTranslationAvailableA(electric.xml.Attribute a)

getAttributeMap

public java.util.HashMap getAttributeMap()

Description copied from class: FInputPanel

Returns the map of attributes supported by this component.

Specified by:

getAttributeMap in interface FormElementI

Overrides:

getAttributeMap in class FInputPanel

Returns:

The attribute map.

getElementMap

public java.util.HashMap getElementMap()

Description copied from class: FInputPanel

Returns the map of elements supported by this component.

Specified by:

getElementMap in interface FormElementI

Overrides:

getElementMap in class FInputPanel

Returns:

The element map.

getDefaultActionMap

public java.util.LinkedHashMap getDefaultActionMap()

Description copied from class: FInputPanel

Returns the default action map for this component.

Overrides:

getDefaultActionMap in class FInputPanel

Returns:

The default action map.

calculateDisplayValue

public java.lang.Object calculateDisplayValue(AsyncRefreshRequestI r)

Description copied from interface: AsyncRefreshExecutorI

Calculates a display value for an asynchronous refresh request. Possibly also calculates some internal settings for the component. This method is intended to be executed on a background thread to perform a potentially long-running or resource-intensive calculation without blocking the UI. Therefore it must not run on the EDT thread and must not directly modify the GUI. The returned object is the raw, non-rendered value that will be passed to the renderDisplayValue method.

Specified by:

calculateDisplayValue in interface AsyncRefreshExecutorI

Parameters:

r - The refresh request containing all necessary context and data for the calculation.

Returns:

The calculated value, which can be any Object.

renderDisplayValue

public void renderDisplayValue(AsyncRefreshRequestI r,
                               java.lang.Object displayValue)

Description copied from interface: AsyncRefreshExecutorI

Renders the calculated value on the UI. This method is executed on the EDT thread (the Event Dispatch Thread in Swing) and is responsible for safely updating the visual component with the provided value. This ensures that UI modifications happen in a thread-safe manner.

Specified by:

renderDisplayValue in interface AsyncRefreshExecutorI

Parameters:

r - The original refresh request.

displayValue - The raw Object value returned by the calculateDisplayValue method, or a caught Exception.

lockDisplayValue

public void lockDisplayValue()

Description copied from interface: AsyncRefreshExecutorI

Locks the UI component that displays the value to prevent concurrent inputs during async refresh operations. This method is called before the background calculation begins. It should lock or disable the relevant UI component to prevent the user from interacting with it while it is being updated, thereby avoiding inconsistent state or unexpected behavior.

Specified by:

lockDisplayValue in interface AsyncRefreshExecutorI

restoreLockstateOfDisplayValue

public void restoreLockstateOfDisplayValue()

Description copied from interface: AsyncRefreshExecutorI

Unlocks the UI component that displays the value again. This method is called after the value has been rendered. It is responsible for restoring the UI component's state to its original, unlocked state.

Specified by:

restoreLockstateOfDisplayValue in interface AsyncRefreshExecutorI

getDisplayValue

public java.lang.String getDisplayValue(AttributeI att,
                                        BO bo)

syncImpl

public void syncImpl()

Overrides:

syncImpl in class FPanel

setBOValue

public void setBOValue(AttributeI att,
                       BO bo,
                       java.lang.String dt)

keyPressed

public void keyPressed(java.awt.event.KeyEvent e)

Specified by:

keyPressed in interface java.awt.event.KeyListener

keyReleased

public void keyReleased(java.awt.event.KeyEvent e)

Specified by:

keyReleased in interface java.awt.event.KeyListener

keyTyped

public void keyTyped(java.awt.event.KeyEvent e)

Specified by:

keyTyped in interface java.awt.event.KeyListener