de.ipcon.form

Class FTimespanChooser

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.FTimespanChooser

All Implemented Interfaces:

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

public class FTimespanChooser
extends FInputPanel
implements java.awt.event.ActionListener, java.awt.event.MouseListener, java.awt.event.KeyListener, InitialFocusCandidateI, FormElementWithDisplayPropertyI, AsyncRefreshExecutorI

Timespan input control. Code heavily based on FDateChooser code. FIXME Will probably be dropped, since we now have the nicer SimpleTimespanChooser... TT 2019-05-08: Still used in a significant number of forms in CVS though.

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 inherited from class de.ipcon.form.FInputPanel

myActions

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
FTimespanChooser(FormContextI _ftx, electric.xml.Element _confroot)

Method Summary

Modifier and Type	Method and Description
void	actionPerformed(java.awt.event.ActionEvent e)
java.lang.Object	calculateDisplayValue(AsyncRefreshRequestI r) Calculates a display value for an asynchronous refresh request.
void	close()
void	dateChanged(java.lang.Long d, boolean committed)
void	disable()
void	enable()
java.util.HashMap	getAttributeMap() Returns the map of attributes supported by this component.
java.lang.String	getDisplayProperty()
java.util.HashMap	getElementMap() Returns the map of elements supported by this component.
javax.swing.JComponent	getInitialFocus()
javax.swing.JComponent	getJComponent() Returns the "JComponent" associated with this form element.
void	handleDisplayFormatA(electric.xml.Attribute a)
void	handleDisplayPropertyA(electric.xml.Attribute a)
void	handlePropertyA(electric.xml.Attribute a)
void	init()
void	keyPressed(java.awt.event.KeyEvent ke)
void	keyReleased(java.awt.event.KeyEvent ke)
void	keyTyped(java.awt.event.KeyEvent ke)
void	lockDisplayValue() Locks the UI component that displays the value to prevent concurrent inputs during async refresh operations.
void	mouseClicked(java.awt.event.MouseEvent me)
void	mouseEntered(java.awt.event.MouseEvent me)
void	mouseExited(java.awt.event.MouseEvent me)
void	mousePressed(java.awt.event.MouseEvent me)
void	mouseReleased(java.awt.event.MouseEvent me)
void	postRefresh()
void	postRefresh(int from)
void	refresh(int from)
void	renderDisplayValue(AsyncRefreshRequestI r, java.lang.Object displayValue) Renders the calculated value on the UI.
boolean	requestFocusInWindow() Requests that this component gets the keyboard focus, specifically within its own window.
void	restoreLockstateOfDisplayValue() Unlocks the UI component that displays the value again.
java.lang.Long	setAndReturnBOValue() Set the value of the BO attribute to the timespan (number of seconds) value that is represented by the text entered in the text field and returns that value.
void	setDisplayProperty(java.lang.String $4)
boolean	setEditable()
boolean	setEditable(boolean b)
void	setEnabled()
void	setEnabled(boolean b)
void	showTimespan()
void	syncImpl()

Methods inherited from class de.ipcon.form.FInputPanel

calculateMandatory, getAlsoMandatoryIf, getBaseline, getDefaultActionMap, 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, handleAttributes, 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, registerActionImpl, 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, 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, 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, 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, refresh, removeFormElementListener, requestFocus, sync, toDebugName, willCareForChildActions, willCareForChildRefresh

Constructor Detail

FTimespanChooser

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

Method Detail

close

public void close()

Specified by:

close in interface FormElementI

Overrides:

close in class FPanel

handleDisplayPropertyA

public void handleDisplayPropertyA(electric.xml.Attribute a)

handlePropertyA

public void handlePropertyA(electric.xml.Attribute a)

handleDisplayFormatA

public void handleDisplayFormatA(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.

init

public void init()

Overrides:

init in class de.ipcon.swing.IPanel

refresh

public void refresh(int from)

Specified by:

refresh in interface FormElementI

Overrides:

refresh in class FPanel

postRefresh

public void postRefresh()

Overrides:

postRefresh in class FPanel

postRefresh

public void postRefresh(int from)

Specified by:

postRefresh in interface FormElementI

Overrides:

postRefresh in class FPanel

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

setAndReturnBOValue

public java.lang.Long setAndReturnBOValue()

Set the value of the BO attribute to the timespan (number of seconds) value that is represented by the text entered in the text field and returns that value.

syncImpl

public void syncImpl()

Overrides:

syncImpl in class FPanel

showTimespan

public void showTimespan()

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent e)

Specified by:

actionPerformed in interface java.awt.event.ActionListener

mouseClicked

public void mouseClicked(java.awt.event.MouseEvent me)

Specified by:

mouseClicked in interface java.awt.event.MouseListener

mousePressed

public void mousePressed(java.awt.event.MouseEvent me)

Specified by:

mousePressed in interface java.awt.event.MouseListener

mouseReleased

public void mouseReleased(java.awt.event.MouseEvent me)

Specified by:

mouseReleased in interface java.awt.event.MouseListener

mouseEntered

public void mouseEntered(java.awt.event.MouseEvent me)

Specified by:

mouseEntered in interface java.awt.event.MouseListener

mouseExited

public void mouseExited(java.awt.event.MouseEvent me)

Specified by:

mouseExited in interface java.awt.event.MouseListener

keyTyped

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

Specified by:

keyTyped in interface java.awt.event.KeyListener

keyPressed

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

Specified by:

keyPressed in interface java.awt.event.KeyListener

keyReleased

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

Specified by:

keyReleased in interface java.awt.event.KeyListener

dateChanged

public void dateChanged(java.lang.Long d,
                        boolean committed)

setEnabled

public void setEnabled()

setEnabled

public void setEnabled(boolean b)

Overrides:

setEnabled in class javax.swing.JComponent

disable

public void disable()

Overrides:

disable in class javax.swing.JComponent

enable

public void enable()

Overrides:

enable in class javax.swing.JComponent

setEditable

public boolean setEditable()

setEditable

public boolean setEditable(boolean b)

Specified by:

setEditable in interface FormElementI

Overrides:

setEditable in class FPanel

getInitialFocus

public javax.swing.JComponent getInitialFocus()

Specified by:

getInitialFocus in interface InitialFocusCandidateI

getJComponent

public javax.swing.JComponent getJComponent()

Description copied from class: FInputPanel

Returns the "JComponent" associated with this form element.

Specified by:

getJComponent in class FInputPanel

Returns:

The "JComponent" of this form element.

requestFocusInWindow

public boolean requestFocusInWindow()

Description copied from class: FPanel

Requests that this component gets the keyboard focus, specifically within its own window.

This method overrides JComponent.requestFocusInWindow() and delegates to the more specific FPanel.requestFocusInWindow(boolean) with "temporary" set to false.

Overrides:

requestFocusInWindow in class FPanel

Returns:

true if the focus request is likely to be granted, false otherwise.

getDisplayProperty

public java.lang.String getDisplayProperty()

Specified by:

getDisplayProperty in interface FormElementWithDisplayPropertyI

setDisplayProperty

public void setDisplayProperty(java.lang.String $4)