de.ipcon.form

Class FPanel

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

de.ipcon.swing.IPanel

de.ipcon.form.FPanel

All Implemented Interfaces:

FormElementI, de.ipcon.swing.FocusVetoHandlerI, L10nApplicatorI, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible, javax.swing.Scrollable

Direct Known Subclasses:

FBorder, FButton, FCanvas, FChart, FEditor, FHideablePanel, FImage, FInputPanel, FJRDesignViewer, FLabel, FLocked, FPDFViewer, FRootPane, FScheduler, FTable, FTree

public abstract class FPanel
extends de.ipcon.swing.IPanel
implements de.ipcon.swing.FocusVetoHandlerI, FormElementI

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<java.lang.String,MethodLocalizationWrapper>	myAttributes
static java.util.HashMap<java.lang.String,java.lang.reflect.Method>	myElements
static java.lang.String	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_SHOW_POPUP, 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
FPanel(FormContextI _ftx, electric.xml.Element _confRoot)

Method Summary

Modifier and Type	Method and Description
void	_refreshActions() Executes the actual logic to update the state of all Form Actions.
boolean	action_editForm_available()
boolean	action_editForm_enabled()
void	action_editForm()
boolean	action_refreshView_available()
void	action_refreshView()
boolean	action_reopenView_available()
boolean	action_reopenView_enabled()
void	action_reopenView()
void	addFormElementListener(FormElementListenerI l)
void	afterSave()
void	afterSetValue(java.lang.Object old, java.lang.Object $new)
void	assureTransferHandler()
void	beforeSave()
void	beforeSetValue(java.lang.Object old, java.lang.Object $new)
boolean	calculationMightBeExpensive()
void	callLog(java.lang.String s)
void	cancelPendingRefreshRequests()
boolean	checkEditable()
boolean	checkVisible()
void	close()
java.lang.Object	evalScript(java.lang.String name)
java.lang.Object	evalScript(java.lang.String name, boolean showException)
java.lang.Object	evalScript(java.lang.String name, java.lang.String[] argNames, java.lang.Class[] argTypes, java.lang.Object[] argValues)
java.lang.Object	evalScript(java.lang.String name, java.lang.String[] argNames, java.lang.Class[] argTypes, java.lang.Object[] argValues, boolean showException)
java.lang.Object	evalScript(java.lang.String name, java.lang.String[] argNames, java.lang.Class[] argTypes, java.lang.Object[] argValues, boolean showException, boolean allowDeclare)
void	fhide() Executes custom actions when the component becomes hidden.
void	focusNextComponent(java.awt.KeyboardFocusManager kfm)
void	focusPreviousComponent(java.awt.KeyboardFocusManager kfm)
void	fshow() Executes custom actions when the component becomes visible.
java.util.LinkedHashMap	getActions()
java.util.LinkedHashMap	getActionsOfKind(int kind)
static java.util.LinkedHashMap	getActionsOfKind(java.util.Map _actions, int kind)
java.util.HashMap<java.lang.String,MethodLocalizationWrapper>	getAttributeMap() Returns the map of attributes supported by this FPanel.
BO	getBO()
electric.xml.Element	getConfRoot()
ClientContextI	getCtx()
java.lang.String	getDebugName()
java.util.LinkedHashMap	getDefaultActionMap() Returns the default action map for this FPanel.
DefinitionErrorHandlerI	getDefinitionErrorHandler()
java.util.HashMap	getElementMap() Returns the map of elements supported by this FPanel.
java.util.LinkedHashMap	getFormActions()
FormContextI	getFtx()
InstrumentingSchemaI	getInstrumentedSchema()
java.util.concurrent.atomic.AtomicLong	getLastRefreshRequest()
java.awt.Dimension	getMaximumSize()
java.awt.Dimension	getMinimumSize()
java.lang.String	getMissingPropertiesPolicy()
java.awt.Dimension	getPreferredSize()
java.util.concurrent.atomic.AtomicInteger	getRefreshRequestsPending()
SchemaI	getSchema()
void	handleActionE(electric.xml.Element e)
void	handleDropAllowedIfE(electric.xml.Element e)
void	handleEditableA(java.lang.String value)
void	handleEditableIfE(electric.xml.Element e)
void	handleImpliedA(java.lang.String value)
void	handleMaximumSizeA(java.lang.String value)
void	handleMaxSizeA(java.lang.String value)
void	handleMinimumSizeA(java.lang.String value)
void	handleMinSizeA(java.lang.String value)
void	handleMissingPropertiesPolicyA(java.lang.String value)
void	handleNameA(java.lang.String value)
void	handleOnAfterSaveE(electric.xml.Element e)
void	handleOnAfterSetValueE(electric.xml.Element e)
void	handleOnBeforeSaveE(electric.xml.Element e)
void	handleOnBeforeSetValueE(electric.xml.Element e)
void	handleOnConstructionE(electric.xml.Element e)
void	handleOnDropE(electric.xml.Element e)
void	handleOnFocusGainedE(electric.xml.Element e)
void	handleOnFocusLostE(electric.xml.Element e)
void	handleOnMDIActivateE(electric.xml.Element e)
void	handleOnMDICloseE(electric.xml.Element e)
void	handleOnMDIDeactivateE(electric.xml.Element e)
void	handleOnMDIOpenE(electric.xml.Element e)
void	handleOnRefreshE(electric.xml.Element e)
void	handleOnSyncE(electric.xml.Element e)
void	handlePreferredSizeA(java.lang.String value)
void	handlePrefSizeA(java.lang.String value)
void	handleScriptE(electric.xml.Element e)
void	handleVirtualPropertyE(electric.xml.Element e)
void	handleVisibleIfE(electric.xml.Element e)
boolean	hasPreferredSizeOverride()
void	invokeAction(java.lang.String action)
void	invokeAction(java.lang.String action, java.lang.Object parms)
boolean	isClosed()
boolean	isDebug()
boolean	isDefinedEditable()
boolean	isEditable() Checks whether this form element is currently editable.
boolean	isExplicitEditable()
boolean	isGUIBuilt()
boolean	isImpliedElement()
boolean	isInputPossible()
boolean	isShown()
void	mdiActivate(MDIElementI me) Invoked when this form element is activated within an MDI environment.
void	mdiClose(MDIElementI me)
void	mdiDeactivate(MDIElementI me) Invoked when this form element is deactivated within an MDI environment.
void	mdiOpen(MDIElementI me)
void	postConstructor()
void	postInit() Diese Routine wird NACH der Instantiierung des Objektes und seiner UnterObjekte (formulartechnisch gesehen!)
void	postRefresh()
void	postRefresh(int from)
void	postRefresh(int from, boolean suppressRefreshActions)
void	processFocusVeto(java.awt.event.FocusEvent fe)
void	processFocusVeto(java.awt.event.KeyEvent ke)
void	queueDelayedRefresh(AsyncRefreshExecutorI are)
void	queueDelayedRefresh(AsyncRefreshExecutorI are, boolean immediate)
void	reallyHandleVirtualPropertyE(electric.xml.Element e)
void	refresh()
void	refresh(int from)
void	refreshActions() Requests an asynchronous refresh of the form actions associated with this panel.
void	registerActionImpl(FormAction a)
static void	registerDefinitionErrorHandler(DefinitionErrorHandlerI errorHandler)
void	registerFormAction(FormAction a)
void	removeFormElementListener(FormElementListenerI l)
void	requestFocus() Requests that this component gets the keyboard focus.
boolean	requestFocusInWindow() Requests that this component gets the keyboard focus, specifically within its own window.
boolean	requestFocusInWindow(boolean temporary) Requests that this component gets the keyboard focus within its own window, with optional temporary status.
java.lang.Object	runAndDeclare(java.lang.String name)
java.lang.Object	runAndDeclare(java.lang.String name, boolean showException)
void	setConfRoot(electric.xml.Element $52)
void	setDebug(boolean $54)
boolean	setEditable(boolean isEditable) Sets the editable status of this form element.
void	setFtx(FormContextI $51)
void	setGUIBuilt(boolean $55)
void	setMissingPropertiesPolicy(java.lang.String $56)
void	setShown(boolean $53)
boolean	shouldShow()
void	sync()
void	syncImpl()
void	waitForAsyncRefreshes()
boolean	willCareForChildActions()
boolean	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, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, 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, setEnabled, 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

addBeanA, addBeanA, addHandleA, addHandleA, addHandleE, addHandleE, applyL10n, getElementConsideringIgnored, getName, handleAttributes, handleElement, handleElements, handleElements, handleElements, handleElements, handleError, handleNewElement, handleNewElement, handleNewElement, isIgnored, performAdditionalFormElementDefinitionChecks, showError, showError, toDebugName

Field Detail

myAttributes

public static java.util.HashMap<java.lang.String,MethodLocalizationWrapper> myAttributes

myElements

public static java.util.HashMap<java.lang.String,java.lang.reflect.Method> myElements

myActions

public static java.util.LinkedHashMap myActions

XMLConfigureInfo

public static java.lang.String XMLConfigureInfo

Constructor Detail

FPanel

public FPanel(FormContextI _ftx,
              electric.xml.Element _confRoot)

Method Detail

registerDefinitionErrorHandler

public static void registerDefinitionErrorHandler(DefinitionErrorHandlerI errorHandler)

getDefinitionErrorHandler

public DefinitionErrorHandlerI getDefinitionErrorHandler()

Specified by:

getDefinitionErrorHandler in interface FormElementI

getMissingPropertiesPolicy

public java.lang.String getMissingPropertiesPolicy()

queueDelayedRefresh

public void queueDelayedRefresh(AsyncRefreshExecutorI are)

queueDelayedRefresh

public void queueDelayedRefresh(AsyncRefreshExecutorI are,
                                boolean immediate)

getLastRefreshRequest

public java.util.concurrent.atomic.AtomicLong getLastRefreshRequest()

getRefreshRequestsPending

public java.util.concurrent.atomic.AtomicInteger getRefreshRequestsPending()

hasPreferredSizeOverride

public boolean hasPreferredSizeOverride()

cancelPendingRefreshRequests

public void cancelPendingRefreshRequests()

waitForAsyncRefreshes

public void waitForAsyncRefreshes()

calculationMightBeExpensive

public boolean calculationMightBeExpensive()

isClosed

public boolean isClosed()

Specified by:

isClosed in interface FormElementI

close

public void close()

Specified by:

close in interface FormElementI

evalScript

public java.lang.Object evalScript(java.lang.String name)

evalScript

public java.lang.Object evalScript(java.lang.String name,
                                   boolean showException)

evalScript

public java.lang.Object evalScript(java.lang.String name,
                                   java.lang.String[] argNames,
                                   java.lang.Class[] argTypes,
                                   java.lang.Object[] argValues)

evalScript

public java.lang.Object evalScript(java.lang.String name,
                                   java.lang.String[] argNames,
                                   java.lang.Class[] argTypes,
                                   java.lang.Object[] argValues,
                                   boolean showException)

evalScript

public java.lang.Object evalScript(java.lang.String name,
                                   java.lang.String[] argNames,
                                   java.lang.Class[] argTypes,
                                   java.lang.Object[] argValues,
                                   boolean showException,
                                   boolean allowDeclare)

runAndDeclare

public java.lang.Object runAndDeclare(java.lang.String name)

runAndDeclare

public java.lang.Object runAndDeclare(java.lang.String name,
                                      boolean showException)

postConstructor

public void postConstructor()

postInit

public void postInit()

Diese Routine wird NACH der Instantiierung des Objektes und seiner UnterObjekte (formulartechnisch gesehen!) aufgerufen, damit deren moeglichweise benamste Objekte in dem Script bereits ansprechbar sind. Sie sollte neben einem moeglicherweise definiertem Script auch die Aktionen initialisieren (also diesen einen FormContextI zuordnen und an die jeweilige Benutzeroberflaechen-Elemente anbinden.

Specified by:

postInit in interface FormElementI

getDebugName

public java.lang.String getDebugName()

Specified by:

getDebugName in interface FormElementI

callLog

public void callLog(java.lang.String s)

mdiOpen

public void mdiOpen(MDIElementI me)

Specified by:

mdiOpen in interface FormElementI

mdiClose

public void mdiClose(MDIElementI me)

Specified by:

mdiClose in interface FormElementI

mdiActivate

public void mdiActivate(MDIElementI me)

Description copied from interface: FormElementI

Invoked when this form element is activated within an MDI environment.

This method is called when the form element becomes the active, or currently selected, component in its MDI parent. Implementations should handle any necessary updates, refreshes, or setup that needs to occur when the element is brought into focus.

Specified by:

mdiActivate in interface FormElementI

Parameters:

me - The MDIElementI that is being activated.

mdiDeactivate

public void mdiDeactivate(MDIElementI me)

Description copied from interface: FormElementI

Invoked when this form element is deactivated within an MDI environment.

This method is called when the form element is no longer the active component in its MDI parent. Implementations should handle any necessary cleanup, state saving, or resource release that needs to occur when the element loses focus.

Specified by:

mdiDeactivate in interface FormElementI

Parameters:

me - The MDIElementI that is being deactivated.

registerActionImpl

public void registerActionImpl(FormAction a)

getActions

public java.util.LinkedHashMap getActions()

Specified by:

getActions in interface FormElementI

getActionsOfKind

public java.util.LinkedHashMap getActionsOfKind(int kind)

Specified by:

getActionsOfKind in interface FormElementI

getActionsOfKind

public static java.util.LinkedHashMap getActionsOfKind(java.util.Map _actions,
                                                       int kind)

action_editForm_available

public boolean action_editForm_available()

action_editForm_enabled

public boolean action_editForm_enabled()

action_editForm

public void action_editForm()

action_reopenView_available

public boolean action_reopenView_available()

action_reopenView_enabled

public boolean action_reopenView_enabled()

action_reopenView

public void action_reopenView()

action_refreshView_available

public boolean action_refreshView_available()

action_refreshView

public void action_refreshView()

getAttributeMap

public java.util.HashMap<java.lang.String,MethodLocalizationWrapper> getAttributeMap()

Returns the map of attributes supported by this FPanel.

Subclasses can and should override this method to provide their own attribute map.

Specified by:

getAttributeMap in interface FormElementI

Returns:

The attribute map.

getElementMap

public java.util.HashMap getElementMap()

Returns the map of elements supported by this FPanel.

Subclasses can and should override this method to provide their own element map.

Specified by:

getElementMap in interface FormElementI

Returns:

The element map.

getDefaultActionMap

public java.util.LinkedHashMap getDefaultActionMap()

Returns the default action map for this FPanel.

Subclasses can and should override this method to provide their own default action map.

Returns:

The default action map.

handleNameA

public void handleNameA(java.lang.String value)

handleEditableA

public void handleEditableA(java.lang.String value)

handleImpliedA

public void handleImpliedA(java.lang.String value)

handleMinimumSizeA

public void handleMinimumSizeA(java.lang.String value)

handleMinSizeA

public void handleMinSizeA(java.lang.String value)

handlePreferredSizeA

public void handlePreferredSizeA(java.lang.String value)

handlePrefSizeA

public void handlePrefSizeA(java.lang.String value)

handleMaximumSizeA

public void handleMaximumSizeA(java.lang.String value)

handleMaxSizeA

public void handleMaxSizeA(java.lang.String value)

handleMissingPropertiesPolicyA

public void handleMissingPropertiesPolicyA(java.lang.String value)

handleScriptE

public void handleScriptE(electric.xml.Element e)

handleOnConstructionE

public void handleOnConstructionE(electric.xml.Element e)

handleOnFocusGainedE

public void handleOnFocusGainedE(electric.xml.Element e)

handleOnFocusLostE

public void handleOnFocusLostE(electric.xml.Element e)

handleOnSyncE

public void handleOnSyncE(electric.xml.Element e)

handleOnRefreshE

public void handleOnRefreshE(electric.xml.Element e)

handleOnBeforeSaveE

public void handleOnBeforeSaveE(electric.xml.Element e)

handleOnAfterSaveE

public void handleOnAfterSaveE(electric.xml.Element e)

handleOnBeforeSetValueE

public void handleOnBeforeSetValueE(electric.xml.Element e)

handleOnAfterSetValueE

public void handleOnAfterSetValueE(electric.xml.Element e)

handleOnMDIOpenE

public void handleOnMDIOpenE(electric.xml.Element e)

handleOnMDICloseE

public void handleOnMDICloseE(electric.xml.Element e)

handleOnMDIActivateE

public void handleOnMDIActivateE(electric.xml.Element e)

handleOnMDIDeactivateE

public void handleOnMDIDeactivateE(electric.xml.Element e)

handleEditableIfE

public void handleEditableIfE(electric.xml.Element e)

handleDropAllowedIfE

public void handleDropAllowedIfE(electric.xml.Element e)

handleOnDropE

public void handleOnDropE(electric.xml.Element e)

assureTransferHandler

public void assureTransferHandler()

handleActionE

public void handleActionE(electric.xml.Element e)

handleVirtualPropertyE

public void handleVirtualPropertyE(electric.xml.Element e)

handleVisibleIfE

public void handleVisibleIfE(electric.xml.Element e)

getInstrumentedSchema

public InstrumentingSchemaI getInstrumentedSchema()

reallyHandleVirtualPropertyE

public void reallyHandleVirtualPropertyE(electric.xml.Element e)

invokeAction

public void invokeAction(java.lang.String action)

invokeAction

public void invokeAction(java.lang.String action,
                         java.lang.Object parms)

getCtx

public ClientContextI getCtx()

Specified by:

getCtx in interface FormElementI

getSchema

public SchemaI getSchema()

Specified by:

getSchema in interface FormElementI

getBO

public BO getBO()

sync

public final void sync()

Specified by:

sync in interface FormElementI

syncImpl

public void syncImpl()

getFormActions

public java.util.LinkedHashMap getFormActions()

registerFormAction

public void registerFormAction(FormAction a)

addFormElementListener

public void addFormElementListener(FormElementListenerI l)

Specified by:

addFormElementListener in interface FormElementI

removeFormElementListener

public void removeFormElementListener(FormElementListenerI l)

Specified by:

removeFormElementListener in interface FormElementI

beforeSave

public void beforeSave()

Specified by:

beforeSave in interface FormElementI

afterSave

public void afterSave()

Specified by:

afterSave in interface FormElementI

shouldShow

public boolean shouldShow()

willCareForChildRefresh

public boolean willCareForChildRefresh()

Specified by:

willCareForChildRefresh in interface FormElementI

willCareForChildActions

public boolean willCareForChildActions()

Specified by:

willCareForChildActions in interface FormElementI

refresh

public void refresh()

Specified by:

refresh in interface FormElementI

refresh

public void refresh(int from)

Specified by:

refresh in interface FormElementI

postRefresh

public void postRefresh()

postRefresh

public void postRefresh(int from)

Specified by:

postRefresh in interface FormElementI

postRefresh

public void postRefresh(int from,
                        boolean suppressRefreshActions)

refreshActions

public void refreshActions()

Requests an asynchronous refresh of the form actions associated with this panel.

This method implements a request coalescing pattern:

• It ensures that _refreshActions() is executed at most once, even if this method is called multiple times in rapid succession.
• It utilizes an AtomicBoolean latch (scheduledUpdate) to filter out redundant requests.
• The actual execution occurs asynchronously on the Event Dispatch Thread (EDT) to prevent UI blocking.

_refreshActions

public void _refreshActions()

Executes the actual logic to update the state of all Form Actions.

This method is intended to run on the EDT. It iterates over all registered FormActions and triggers a re-evaluation of their enabled state via FormAction.checkIfEnabled().

Key Behaviors:

• Latch Reset: The concurrency latch is released immediately at the start, allowing new refresh requests to be scheduled while this one is still processing.
• Fault Tolerance: Each action is updated in isolation. If one action fails (throws a RuntimeException), it is logged, and the loop continues to process the remaining actions.

beforeSetValue

public void beforeSetValue(java.lang.Object old,
                           java.lang.Object $new)

Specified by:

beforeSetValue in interface FormElementI

afterSetValue

public void afterSetValue(java.lang.Object old,
                          java.lang.Object $new)

Specified by:

afterSetValue in interface FormElementI

processFocusVeto

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

Specified by:

processFocusVeto in interface de.ipcon.swing.FocusVetoHandlerI

processFocusVeto

public void processFocusVeto(java.awt.event.FocusEvent fe)

Specified by:

processFocusVeto in interface de.ipcon.swing.FocusVetoHandlerI

focusNextComponent

public void focusNextComponent(java.awt.KeyboardFocusManager kfm)

focusPreviousComponent

public void focusPreviousComponent(java.awt.KeyboardFocusManager kfm)

setEditable

public boolean setEditable(boolean isEditable)

Description copied from interface: FormElementI

Sets the editable status of this form element.

The return value is critical for the recursive application of the editable status within the form context (ftx). It ensures efficient iteration without redundancy by serving as the value passed down to child elements.

Specified by:

setEditable in interface FormElementI

Parameters:

isEditable - true to make the element editable; false otherwise.

Returns:

The boolean value intended to be propagated to child elements within the structure.

isEditable

public boolean isEditable()

Description copied from interface: FormElementI

Checks whether this form element is currently editable.

Specified by:

isEditable in interface FormElementI

Returns:

true if the element is editable; false otherwise.

isDefinedEditable

public boolean isDefinedEditable()

Returns:

true if the FormElement is defined as editable

isExplicitEditable

public boolean isExplicitEditable()

Returns:

true if the property is defined as editable (either in the code or in the schema)

isInputPossible

public boolean isInputPossible()

Specified by:

isInputPossible in interface FormElementI

isImpliedElement

public boolean isImpliedElement()

checkVisible

public boolean checkVisible()

checkEditable

public boolean checkEditable()

fshow

public void fshow()

Executes custom actions when the component becomes visible.

This method prevents redundant GUI building if the component was already visible. It first calls buildGUI() to construct the graphical user interface, and then postBuildGUI() to perform any post-construction setup. Finally, it marks the component as visible.

fhide

public void fhide()

Executes custom actions when the component becomes hidden.

This method is a placeholder for any cleanup or state changes that need to occur when the component is no longer visible. The current implementation does nothing. Subclasses may override this.

requestFocus

public void requestFocus()

Requests that this component gets the keyboard focus.

This method overrides JComponent.requestFocus() to ensure that focus changes remain strictly within the current window. It delegates directly to requestFocusInWindow() to prevent components from indiscriminately grabbing focus from other windows.

Specified by:

requestFocus in interface FormElementI

Overrides:

requestFocus in class de.ipcon.swing.IPanel

requestFocusInWindow

public boolean requestFocusInWindow()

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

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

Overrides:

requestFocusInWindow in class javax.swing.JComponent

Returns:

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

requestFocusInWindow

public boolean requestFocusInWindow(boolean temporary)

Requests that this component gets the keyboard focus within its own window, with optional temporary status.

This method overrides JComponent.requestFocusInWindow(boolean). It contains custom logic to manage the initial focus. If the component itself is an InitialFocusCandidateI, it attempts to set focus to its designated initial component. Otherwise, it attempts to set focus to itself.

If the focus request fails (either for the designated component or itself), it registers this component as an explicit initial focus candidate with the root form element, ensuring focus is eventually set.

Overrides:

requestFocusInWindow in class javax.swing.JComponent

Parameters:

temporary - If true, the focus transfer is temporary and may be reverted.

Returns:

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

getMinimumSize

public java.awt.Dimension getMinimumSize()

Overrides:

getMinimumSize in class javax.swing.JComponent

getPreferredSize

public java.awt.Dimension getPreferredSize()

Overrides:

getPreferredSize in class javax.swing.JComponent

getMaximumSize

public java.awt.Dimension getMaximumSize()

Overrides:

getMaximumSize in class javax.swing.JComponent

getFtx

public FormContextI getFtx()

Specified by:

getFtx in interface FormElementI

setFtx

public void setFtx(FormContextI $51)

getConfRoot

public electric.xml.Element getConfRoot()

Specified by:

getConfRoot in interface FormElementI

setConfRoot

public void setConfRoot(electric.xml.Element $52)

isShown

public boolean isShown()

Specified by:

isShown in interface FormElementI

setShown

public void setShown(boolean $53)

isDebug

public boolean isDebug()

Specified by:

isDebug in interface FormElementI

setDebug

public void setDebug(boolean $54)

isGUIBuilt

public boolean isGUIBuilt()

Specified by:

isGUIBuilt in interface FormElementI

setGUIBuilt

public void setGUIBuilt(boolean $55)

setMissingPropertiesPolicy

public void setMissingPropertiesPolicy(java.lang.String $56)