de.ipcon.form

Class FDateChooser

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

All Implemented Interfaces:

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

public class FDateChooser
extends FTextInputComponent
implements de.ipcon.swing.IDateChooserPanelListener, FormElementWithDisplayPropertyI, de.ipcon.swing.PopupListenerI

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

Method Summary

Modifier and Type	Method and Description
boolean	action_togglePopup_available()
boolean	action_togglePopup_enabled()
void	action_togglePopup(java.awt.event.ActionEvent event)
void	buildGUI()
java.lang.Object	calculateDisplayValue(AsyncRefreshRequestI r) Calculates a display value for an asynchronous refresh request.
void	close()
void	closeDateChooser()
void	createIconPanel()
void	createTextField()
void	dateChanged(java.util.Date d)
void	determineTimezone() Uses the determined property/attribute to fetch the actual timezone to use.
void	determineTimezoneProperty() Resolve the property which determines the timezone, if available.
java.util.HashMap	getAttributeMap() Returns the map of attributes supported by this component.
de.ipcon.swing.IDateChooserPanel	getDateChooserPanel(java.util.Date initialDate)
java.util.LinkedHashMap	getDefaultActionMap() Returns the default action map for this component.
java.lang.String	getDisplayFormat()
java.lang.String	getDisplayProperty()
java.util.HashMap	getElementMap() Returns the map of elements supported by this component.
javax.swing.text.JTextComponent	getTextComponent()
void	handleAutoHideButtonA(electric.xml.Attribute a)
void	handleDisplayPropertyA(electric.xml.Attribute a)
void	handleEnabledA(electric.xml.Attribute a)
void	handleFormatA(electric.xml.Attribute a)
void	handleInputFormatE(electric.xml.Element e)
void	handlePopupHeightA(electric.xml.Attribute a)
void	handlePopupSizeA(electric.xml.Attribute a)
void	handlePopupWidthA(electric.xml.Attribute a)
void	handleTimeZonePropertyA(electric.xml.Attribute a)
void	hidePopup()
boolean	isPopupVisible()
void	lockDisplayValue() Locks the UI component that displays the value to prevent concurrent inputs during async refresh operations.
void	popupAboutToHide(de.ipcon.swing.IResizablePopupWindow _popup)
void	popupHidden(de.ipcon.swing.IResizablePopupWindow _popup)
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	setDisplayFormat(java.lang.String $10)
void	showDate()
void	showDate(boolean _doSync)
void	syncImpl() Ein Sync wird immer dann ausgeloest, wenn die Komponente den Focus verliert oder der Benutzer die Speichern-Aktion ausloest (oder halt jemand explizit sync() aufruft auf einem parent ftx) Wir muessen halt nur aufpassen, dass der Wert, der im BO steckt, nicht durch sync()-Aufrufe veraendert wird, wenn der Benutzer keine Aenderung im View wahrnimmt - das ist ein Problem beim Aendern eines Datums in der GUI.
void	togglePopup(java.awt.event.ActionEvent event)

Methods inherited from class de.ipcon.form.FTextInputComponent

_setText, changedUpdate, disable, enable, focusGained, focusLost, getAlign, getBaseline, getColumns, getExplicitNullProperty, getFallbackProperty, getFontSize, getFontStyle, getInitialFocus, getJComponent, 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, 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, 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

Constructor Detail

FDateChooser

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

Method Detail

getTextComponent

public javax.swing.text.JTextComponent getTextComponent()

Specified by:

getTextComponent in class FTextInputComponent

close

public void close()

Specified by:

close in interface FormElementI

Overrides:

close in class FTextInputComponent

getDisplayProperty

public java.lang.String getDisplayProperty()

Specified by:

getDisplayProperty in interface FormElementWithDisplayPropertyI

buildGUI

public void buildGUI()

determineTimezoneProperty

public void determineTimezoneProperty()

Resolve the property which determines the timezone, if available. Might be defined in schema or form XML.

determineTimezone

public void determineTimezone()

Uses the determined property/attribute to fetch the actual timezone to use.

See Also:

determineTimezoneProperty()

handleDisplayPropertyA

public void handleDisplayPropertyA(electric.xml.Attribute a)

handleFormatA

public void handleFormatA(electric.xml.Attribute a)

handlePopupHeightA

public void handlePopupHeightA(electric.xml.Attribute a)

handlePopupWidthA

public void handlePopupWidthA(electric.xml.Attribute a)

handlePopupSizeA

public void handlePopupSizeA(electric.xml.Attribute a)

handleInputFormatE

public void handleInputFormatE(electric.xml.Element e)

handleAutoHideButtonA

public void handleAutoHideButtonA(electric.xml.Attribute a)

handleTimeZonePropertyA

public void handleTimeZonePropertyA(electric.xml.Attribute a)

handleEnabledA

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

createTextField

public void createTextField()

createIconPanel

public void createIconPanel()

getDateChooserPanel

public de.ipcon.swing.IDateChooserPanel getDateChooserPanel(java.util.Date initialDate)

isPopupVisible

public boolean isPopupVisible()

popupHidden

public void popupHidden(de.ipcon.swing.IResizablePopupWindow _popup)

Specified by:

popupHidden in interface de.ipcon.swing.PopupListenerI

popupAboutToHide

public void popupAboutToHide(de.ipcon.swing.IResizablePopupWindow _popup)

Specified by:

popupAboutToHide in interface de.ipcon.swing.PopupListenerI

hidePopup

public void hidePopup()

togglePopup

public void togglePopup(java.awt.event.ActionEvent event)

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

showDate

public void showDate()

showDate

public void showDate(boolean _doSync)

syncImpl

public void syncImpl()

Ein Sync wird immer dann ausgeloest, wenn die Komponente den Focus verliert oder der Benutzer die Speichern-Aktion ausloest (oder halt jemand explizit sync() aufruft auf einem parent ftx) Wir muessen halt nur aufpassen, dass der Wert, der im BO steckt, nicht durch sync()-Aufrufe veraendert wird, wenn der Benutzer keine Aenderung im View wahrnimmt - das ist ein Problem beim Aendern eines Datums in der GUI. Zu diesem Zweck lesen wir das BO aus, vergleichen den Wert mit dem Wert im Eingabefeld, und wenn die zwei uebereinstimmen machen wir nichts.

Overrides:

syncImpl in class FPanel

action_togglePopup

public void action_togglePopup(java.awt.event.ActionEvent event)

action_togglePopup_enabled

public boolean action_togglePopup_enabled()

action_togglePopup_available

public boolean action_togglePopup_available()

dateChanged

public void dateChanged(java.util.Date d)

Specified by:

dateChanged in interface de.ipcon.swing.IDateChooserPanelListener

closeDateChooser

public void closeDateChooser()

Specified by:

closeDateChooser in interface de.ipcon.swing.IDateChooserPanelListener

getDisplayFormat

public java.lang.String getDisplayFormat()

setDisplayFormat

public void setDisplayFormat(java.lang.String $10)