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, 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	myAttributes
static java.util.HashMap	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_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() Performs the actual refresh of the 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	addBeanA(java.util.Map m, java.lang.String attributeName)
void	addFormElementListener(FormElementListenerI l)
void	addHandleA(java.util.Map m, java.lang.String attributeName)
void	addHandleE(java.util.Map m, java.lang.String el)
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	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.
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	handleAttributes(java.util.HashMap attributeHashMap)
void	handleDropAllowedIfE(electric.xml.Element e)
void	handleEditableA(electric.xml.Attribute _attr)
void	handleEditableIfE(electric.xml.Element e)
boolean	handleElement(java.util.HashMap elementHashMap, electric.xml.Element el)
void	handleElements(java.util.HashMap elementHashMap, boolean subsPossible)
void	handleElements(java.util.HashMap elementHashMap, boolean subsPossible, java.lang.String implyElement)
void	handleElements(java.util.HashMap elementHashMap, boolean subsPossible, java.lang.String implyElement, java.lang.String implyPrefix)
void	handleImpliedA(electric.xml.Attribute _attr)
void	handleMaximumSizeA(electric.xml.Attribute a)
void	handleMaxSizeA(electric.xml.Attribute a)
void	handleMinimumSizeA(electric.xml.Attribute a)
void	handleMinSizeA(electric.xml.Attribute a)
void	handleMissingPropertiesPolicyA(electric.xml.Attribute a)
void	handleNameA(electric.xml.Attribute a)
FormElementI	handleNewElement(electric.xml.Element el)
FormElementI	handleNewElement(electric.xml.Element el, java.lang.String aka)
FormElementI	handleNewElement(electric.xml.Element el, java.lang.String aka, FormContextI preparedFtx)
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(electric.xml.Attribute a)
void	handlePrefSizeA(electric.xml.Attribute a)
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()
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() Schedules or immediately executes a refresh of the form actions associated with this panel.
void	refreshActions(boolean sync)
void	registerActionImpl(FormAction a)
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)
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

getName, toDebugName

Field Detail

myAttributes

public static java.util.HashMap myAttributes

myElements

public static java.util.HashMap 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

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()

addBeanA

public void addBeanA(java.util.Map m,
                     java.lang.String attributeName)

addHandleA

public void addHandleA(java.util.Map m,
                       java.lang.String attributeName)

addHandleE

public void addHandleE(java.util.Map m,
                       java.lang.String el)

handleAttributes

public void handleAttributes(java.util.HashMap attributeHashMap)

Specified by:

handleAttributes in interface FormElementI

handleElement

public boolean handleElement(java.util.HashMap elementHashMap,
                             electric.xml.Element el)

Specified by:

handleElement in interface FormElementI

handleElements

public void handleElements(java.util.HashMap elementHashMap,
                           boolean subsPossible)

Specified by:

handleElements in interface FormElementI

handleElements

public void handleElements(java.util.HashMap elementHashMap,
                           boolean subsPossible,
                           java.lang.String implyElement)

handleElements

public void handleElements(java.util.HashMap elementHashMap,
                           boolean subsPossible,
                           java.lang.String implyElement,
                           java.lang.String implyPrefix)

handleNewElement

public FormElementI handleNewElement(electric.xml.Element el)

Specified by:

handleNewElement in interface FormElementI

handleNewElement

public FormElementI handleNewElement(electric.xml.Element el,
                                     java.lang.String aka)

handleNewElement

public FormElementI handleNewElement(electric.xml.Element el,
                                     java.lang.String aka,
                                     FormContextI preparedFtx)

getAttributeMap

public java.util.HashMap 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(electric.xml.Attribute a)

handleEditableA

public void handleEditableA(electric.xml.Attribute _attr)

handleImpliedA

public void handleImpliedA(electric.xml.Attribute _attr)

handleMinimumSizeA

public void handleMinimumSizeA(electric.xml.Attribute a)

handleMinSizeA

public void handleMinSizeA(electric.xml.Attribute a)

handlePreferredSizeA

public void handlePreferredSizeA(electric.xml.Attribute a)

handlePrefSizeA

public void handlePrefSizeA(electric.xml.Attribute a)

handleMaximumSizeA

public void handleMaximumSizeA(electric.xml.Attribute a)

handleMaxSizeA

public void handleMaxSizeA(electric.xml.Attribute a)

handleMissingPropertiesPolicyA

public void handleMissingPropertiesPolicyA(electric.xml.Attribute a)

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()

Schedules or immediately executes a refresh of the form actions associated with this panel.

This method ensures that the "_refreshActions()" logic is executed only once per refresh request. It uses an AtomicBoolean ("scheduledUpdate") to prevent multiple simultaneous or redundant refresh operations from being scheduled.

The refresh can be performed either synchronously (blocking the calling thread until completion) or asynchronously (executing on the Event Dispatch Thread without blocking), depending on the "sync" parameter.

Parameters:

sync - If true, the action refresh is performed synchronously, blocking the calling thread. If false (default), it is scheduled asynchronously on the EDT.

refreshActions

public void refreshActions(boolean sync)

_refreshActions

public void _refreshActions()

Performs the actual refresh of the form actions.

This private method iterates through all FormActions associated with this panel and invokes their "checkIfEnabled()" method. This typically re-evaluates the enabled/disabled state of the actions based on the current form data or business logic. It also resets the "scheduledUpdate" flag to allow future refresh requests.

Actions marked as prototypes (isPrototype()) are skipped, as they are not meant to be directly enabled/disabled. Any runtime exceptions encountered during the "checkIfEnabled()" call for an action are caught and logged to prevent the entire refresh process from failing.

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)

Specified by:

setEditable in interface FormElementI

isEditable

public boolean isEditable()

Specified by:

isEditable in interface FormElementI

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)