de.ipcon.form

Class FView

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

de.ipcon.form.FView

All Implemented Interfaces:

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

public class FView
extends FRootPane

See Also:

Serialized Form

Nested Class Summary

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

javax.swing.JComponent.AccessibleJComponent

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

java.awt.Component.BaselineResizeBehavior

Field Summary

Fields

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

Fields inherited from class de.ipcon.form.FPanel

XMLConfigureInfo

Fields inherited from class de.ipcon.swing.IPanel

inhibitFocusChange, SCROLLING_MODE_ANY, SCROLLING_MODE_HORIZONTAL_ONLY, SCROLLING_MODE_VERTICAL_ONLY, TEXTURE_CENTERED, TEXTURE_REPEAT

Fields inherited from class javax.swing.JComponent

TOOL_TIP_TEXT_KEY, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface de.ipcon.form.FormElementI

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

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

Constructors

Constructor and Description
FView(FormContextI _ftx, electric.xml.Element _confroot)

Method Summary

Modifier and Type	Method and Description
FElement	appendElement(java.lang.String src) Dynamically builds an element from the passed source, sets the BO of its new sub- form-context to the passed BO and appends the element dynamically to this FView.
FElement	appendElement(java.lang.String src, BO bo)
FElement	appendElement(java.lang.String src, BO bo, boolean instantRefresh)
void	buildGUI()
double	calculateDefaultRightFill()
void	close()
void	dumpContainer()
void	dumpContainer(java.awt.Container c)
void	dumpContents(java.awt.Container c, int indent)
void	dumpSingleComponent(java.awt.Component c, int indent)
void	fhide() Executes custom actions when the component becomes hidden.
java.util.LinkedHashMap	getActions() Retrieves a list of all actions associated with this MDI root element.
java.util.HashMap	getAttributeMap() Returns the map of attributes supported by this FPanel.
int	getBaseline(int width, int height)
java.lang.String	getBottomGridAlign()
int	getColumns()
java.util.LinkedHashMap	getDefaultActionMap() Returns the default action map for this FPanel.
double	getDefaultHSpaceDist()
double	getDefaultRightFill()
FView	getDelegatableParent()
FView	getDelegatorView()
java.util.HashMap	getElementMap() Returns the map of elements supported by this FPanel.
java.lang.Integer	getExternalHGap()
java.lang.Integer	getExternalVGap()
de.ipcon.swing.layout.FormPanel	getFormPanel()
java.lang.Integer	getInternalHGap()
java.lang.Integer	getInternalVGap()
FElement	getLastFElement()
java.awt.Dimension	getMinimumSize()
int	getScrollingMode()
java.awt.Color	getTint()
java.lang.String	getTopGridAlign()
void	handleBorderA(electric.xml.Attribute a)
void	handleDefaultHSpaceDistA(electric.xml.Attribute a)
void	handleDefaultRightFillA(electric.xml.Attribute a)
FormElementI	handleElementE(electric.xml.Element e)
void	handleExternalHGapA(electric.xml.Attribute a)
void	handleExternalVGapA(electric.xml.Attribute a)
void	handleInternalHGapA(electric.xml.Attribute a)
void	handleInternalVGapA(electric.xml.Attribute a)
void	handleScrollableA(electric.xml.Attribute a)
void	handleTintA(electric.xml.Attribute a)
void	invalidate()
boolean	isAnyElementVisible()
boolean	isAutoHideElements()
boolean	isBuildRowsFirst()
boolean	isChildOfAnotherView()
boolean	isDelegateToParent()
boolean	isHideElementsForNullBO()
boolean	isScrollable()
void	refresh(int from)
void	refreshActions() Schedules or immediately executes a refresh of the form actions associated with this panel.
void	removeAllElements()
boolean	removeElement(FElement _el)
boolean	requestFocusInWindow() Requests that this component gets the keyboard focus, specifically within its own window.
void	setAutoHideElements(boolean $27)
void	setBottomGridAlign(java.lang.String $32)
void	setBuildRowsFirst(boolean $26)
void	setColumns(int $25)
void	setDefaultHSpaceDist(double $22)
void	setDefaultRightFill(double $21)
void	setDelegateToParent(boolean $29)
void	setExternalHGap(java.lang.Integer $17)
void	setExternalVGap(java.lang.Integer $18)
void	setFormPanel(de.ipcon.swing.layout.FormPanel $16)
void	setHideElementsForNullBO(boolean $28)
void	setInternalHGap(java.lang.Integer $19)
void	setInternalVGap(java.lang.Integer $20)
void	setScrollable(boolean $23)
void	setScrollingMode(int $24)
void	setTint(java.awt.Color $30)
void	setTopGridAlign(java.lang.String $31)

Methods inherited from class de.ipcon.form.FRootPane

action_allowPrebuiltModification_available, action_allowPrebuiltModification, action_close, action_copyId_available, action_copyId_enabled, action_copyId, action_copyXmlExport_available, action_copyXmlExport, action_delete_enabled, action_delete, action_enter_available, action_enter, action_ok_enabled, action_ok, action_print_available, action_print, action_save_enabled, action_save, checkPoint, closeSelfAndView, confirmDelete, confirmDelete, confirmSave, getCurrentlyFocusedFormElement, getCurrentlyFocusedFormElementIfChildOf, getDefaultButton, getExplicitIFC, getL10nBundle, getMDIHeight, getMDIWidth, handleCloseVetoE, handleConflictPolicyA, handleHeightA, handleIgnoreOtherLocalTransactionSavesA, handleL10nBundleA, handleOnBeforeMandatoryCheckE, handleOnCloseE, handleUseMaximumHeightA, handleUseMaximumWidthA, handleWidthA, hasDefaultButton, hasUnfullfilledMandatories, isIgnoreOtherLocalTransactionSaves, isInitialCdeFocus, isPrintingPossible, isUseMaximumHeight, isUseMaximumWidth, mdiActivate, newProcs, postInit, processFocusVeto, putIntoClipboard, save, save, save, setExplicitIFC, setIgnoreOtherLocalTransactionSaves, setInitialCdeFocus, setL10nBundle, setMDIHeight, setMDIWidth, setUseMaximumHeight, setUseMaximumWidth, syncCurrentlyFocusedFormElement

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, focusNextComponent, focusPreviousComponent, fshow, getActions, getActionsOfKind, getActionsOfKind, getBO, getConfRoot, getCtx, getDebugName, getFormActions, getFtx, getInstrumentedSchema, getLastRefreshRequest, getMaximumSize, 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, mdiClose, mdiDeactivate, mdiOpen, postConstructor, postRefresh, postRefresh, postRefresh, processFocusVeto, queueDelayedRefresh, queueDelayedRefresh, reallyHandleVirtualPropertyE, refresh, refreshActions, registerActionImpl, registerFormAction, removeFormElementListener, requestFocus, requestFocusInWindow, runAndDeclare, runAndDeclare, setConfRoot, setDebug, setEditable, setFtx, setGUIBuilt, setMissingPropertiesPolicy, setShown, shouldShow, sync, syncImpl, waitForAsyncRefreshes, willCareForChildActions, willCareForChildRefresh

Methods inherited from class de.ipcon.swing.IPanel

getPreferredScrollableViewportSize, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, grabFocus, init, init, init, paintComponent, 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, 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, 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.swing.FocusVetoHandlerI

processFocusVeto

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

Constructor Detail

FView

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

Method Detail

close

public void close()

Specified by:

close in interface FormElementI

Overrides:

close in class FRootPane

fhide

public void fhide()

Description copied from class: FPanel

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.

Overrides:

fhide in class FPanel

removeAllElements

public void removeAllElements()

appendElement

public FElement appendElement(java.lang.String src)

Dynamically builds an element from the passed source, sets the BO of its new sub- form-context to the passed BO and appends the element dynamically to this FView.

Parameters:

src - the xml-source code to build the element from

bo - the BO to bind to the sub-form-context of the new element

instantRefresh - a boolean indicating if a refreshForms() should be called on the form-context of the new element

Returns:

the newly built FElement

Throws:

IRuntimeException - if the xml-code of the passed source is malformed

appendElement

public FElement appendElement(java.lang.String src,
                              BO bo)

appendElement

public FElement appendElement(java.lang.String src,
                              BO bo,
                              boolean instantRefresh)

removeElement

public boolean removeElement(FElement _el)

buildGUI

public void buildGUI()

getMinimumSize

public java.awt.Dimension getMinimumSize()

Overrides:

getMinimumSize in class FPanel

invalidate

public void invalidate()

Overrides:

invalidate in class java.awt.Container

isChildOfAnotherView

public boolean isChildOfAnotherView()

calculateDefaultRightFill

public double calculateDefaultRightFill()

getDelegatorView

public FView getDelegatorView()

getDelegatableParent

public FView getDelegatableParent()

getFormPanel

public de.ipcon.swing.layout.FormPanel getFormPanel()

getBaseline

public int getBaseline(int width,
                       int height)

Overrides:

getBaseline in class javax.swing.JComponent

handleBorderA

public void handleBorderA(electric.xml.Attribute a)

handleExternalHGapA

public void handleExternalHGapA(electric.xml.Attribute a)

handleExternalVGapA

public void handleExternalVGapA(electric.xml.Attribute a)

handleInternalHGapA

public void handleInternalHGapA(electric.xml.Attribute a)

handleInternalVGapA

public void handleInternalVGapA(electric.xml.Attribute a)

handleDefaultRightFillA

public void handleDefaultRightFillA(electric.xml.Attribute a)

handleDefaultHSpaceDistA

public void handleDefaultHSpaceDistA(electric.xml.Attribute a)

handleScrollableA

public void handleScrollableA(electric.xml.Attribute a)

handleTintA

public void handleTintA(electric.xml.Attribute a)

handleElementE

public FormElementI handleElementE(electric.xml.Element e)

getAttributeMap

public java.util.HashMap getAttributeMap()

Description copied from class: FPanel

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

Overrides:

getAttributeMap in class FRootPane

Returns:

The attribute map.

getElementMap

public java.util.HashMap getElementMap()

Description copied from class: FPanel

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

Overrides:

getElementMap in class FRootPane

Returns:

The element map.

getDefaultActionMap

public java.util.LinkedHashMap getDefaultActionMap()

Description copied from class: FPanel

Returns the default action map for this FPanel.

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

Overrides:

getDefaultActionMap in class FRootPane

Returns:

The default action map.

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.

refresh

public void refresh(int from)

Specified by:

refresh in interface FormElementI

Overrides:

refresh in class FPanel

dumpContainer

public void dumpContainer()

dumpContainer

public void dumpContainer(java.awt.Container c)

dumpContents

public void dumpContents(java.awt.Container c,
                         int indent)

dumpSingleComponent

public void dumpSingleComponent(java.awt.Component c,
                                int indent)

getLastFElement

public FElement getLastFElement()

refreshActions

public void refreshActions()

Description copied from class: FPanel

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.

Overrides:

refreshActions in class FPanel

isAnyElementVisible

public boolean isAnyElementVisible()

setFormPanel

public void setFormPanel(de.ipcon.swing.layout.FormPanel $16)

getExternalHGap

public java.lang.Integer getExternalHGap()

setExternalHGap

public void setExternalHGap(java.lang.Integer $17)

getExternalVGap

public java.lang.Integer getExternalVGap()

setExternalVGap

public void setExternalVGap(java.lang.Integer $18)

getInternalHGap

public java.lang.Integer getInternalHGap()

setInternalHGap

public void setInternalHGap(java.lang.Integer $19)

getInternalVGap

public java.lang.Integer getInternalVGap()

setInternalVGap

public void setInternalVGap(java.lang.Integer $20)

getDefaultRightFill

public double getDefaultRightFill()

setDefaultRightFill

public void setDefaultRightFill(double $21)

getDefaultHSpaceDist

public double getDefaultHSpaceDist()

setDefaultHSpaceDist

public void setDefaultHSpaceDist(double $22)

isScrollable

public boolean isScrollable()

setScrollable

public void setScrollable(boolean $23)

getScrollingMode

public int getScrollingMode()

Overrides:

getScrollingMode in class de.ipcon.swing.IPanel

setScrollingMode

public void setScrollingMode(int $24)

Overrides:

setScrollingMode in class de.ipcon.swing.IPanel

getColumns

public int getColumns()

setColumns

public void setColumns(int $25)

isBuildRowsFirst

public boolean isBuildRowsFirst()

setBuildRowsFirst

public void setBuildRowsFirst(boolean $26)

isAutoHideElements

public boolean isAutoHideElements()

setAutoHideElements

public void setAutoHideElements(boolean $27)

isHideElementsForNullBO

public boolean isHideElementsForNullBO()

setHideElementsForNullBO

public void setHideElementsForNullBO(boolean $28)

isDelegateToParent

public boolean isDelegateToParent()

setDelegateToParent

public void setDelegateToParent(boolean $29)

getTint

public java.awt.Color getTint()

setTint

public void setTint(java.awt.Color $30)

getTopGridAlign

public java.lang.String getTopGridAlign()

setTopGridAlign

public void setTopGridAlign(java.lang.String $31)

getBottomGridAlign

public java.lang.String getBottomGridAlign()

setBottomGridAlign

public void setBottomGridAlign(java.lang.String $32)

getActions

public java.util.LinkedHashMap getActions()

Retrieves a list of all actions associated with this MDI root element.

The returned LinkedHashMap ensures that the order of actions is maintained, typically reflecting their insertion order. This is important for consistent display in menus or toolbars.

Returns:

A LinkedHashMap where keys are action identifiers (e.g. String) and values are the corresponding action objects (e.g. Action, or a custom action type (e.g. FormAction). The map should contain all top-level actions of this MDI root element, preferably in a sorted order.