de.ipcon.form

Class FLabel

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

All Implemented Interfaces:

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

Direct Known Subclasses:

LiquidSeparatorLabel

public class FLabel
extends FPanel
implements FormElementWithDisplayPropertyI, AsyncRefreshExecutorI, java.awt.event.MouseListener, java.awt.event.ActionListener

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

Fields inherited from class de.ipcon.form.FPanel

myActions, 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
FLabel(FormContextI _ftx, electric.xml.Element _confroot)
FLabel(FormContextI _ftx, electric.xml.Element _confroot, boolean _ignoreHandleAttributes)

Method Summary

Modifier and Type	Method and Description
void	actionPerformed(java.awt.event.ActionEvent e)
void	buildGUI()
void	buildGUI(int pos)
java.lang.Object	calculateDisplayValue(AsyncRefreshRequestI r) Calculates a display value for an asynchronous refresh request.
boolean	calculationMightBeExpensive()
void	close()
void	disable()
void	enable()
void	evaluateURL(java.lang.String s) checks if the provided (HTML-)String contains a URL, and if so, extracts the actual URL, and makes the jlabel clickable
java.lang.Boolean	getAsyncRefresh()
java.util.HashMap	getAttributeMap() Returns the map of attributes supported by this FPanel.
int	getBaseline(int width, int height)
java.lang.String	getDisplayFormat()
java.lang.String	getDisplayProperty()
java.util.HashMap	getElementMap() Returns the map of elements supported by this FPanel.
java.lang.String	getFontSize()
java.awt.Color	getIconColor()
javax.swing.JLabel	getLabelComponent()
java.lang.String	getOpenProperty()
java.lang.String	getTextWhileLoading()
void	handleArcA(electric.xml.Attribute a)
void	handleBackgroundA(electric.xml.Attribute a)
void	handleClassA(electric.xml.Attribute a)
void	handleClickableA(electric.xml.Attribute a)
void	handleForegroundA(electric.xml.Attribute a)
void	handleFormatA(electric.xml.Attribute a)
void	handleIconColorA(electric.xml.Attribute a)
void	handleOpenPropertyA(electric.xml.Attribute a)
void	handlePropertyA(electric.xml.Attribute a)
void	handleTextE(electric.xml.Element e)
boolean	isHtml()
boolean	isRequestFocusEnabled()
void	lockDisplayValue() Locks the UI component that displays the value to prevent concurrent inputs during async refresh operations.
void	mouseClicked(java.awt.event.MouseEvent _me)
void	mouseEntered(java.awt.event.MouseEvent _me)
void	mouseExited(java.awt.event.MouseEvent _me)
void	mousePressed(java.awt.event.MouseEvent _me)
void	mouseReleased(java.awt.event.MouseEvent _me)
void	postRefresh()
void	postRefresh(int from)
void	refresh(int from)
void	renderDisplayValue(AsyncRefreshRequestI r, java.lang.Object displayValue) Renders the calculated value on the UI.
void	restoreLockstateOfDisplayValue() Unlocks the UI component that displays the value again.
void	setAsyncRefresh(java.lang.Boolean $12)
void	setDisabledIcon(java.lang.String s)
void	setDisplayFormat(java.lang.String $9)
void	setDisplayProperty(java.lang.String $8)
void	setEnabled()
void	setEnabled(boolean b)
void	setFont(java.lang.String s)
void	setFontSize(java.lang.String s)
void	setFontStyle(java.lang.String s)
void	setGradientStartColor(java.awt.Color c)
void	setGradientStartColor(java.lang.String s)
void	setGradientStartPosition(java.lang.String s)
void	setGradientStopColor(java.awt.Color c)
void	setGradientStopColor(java.lang.String s)
void	setGradientStopPosition(java.lang.String s)
void	setHAlign(java.lang.String s)
void	setHTextPosition(java.lang.String s)
void	setHtml(boolean $11)
void	setIcon(java.lang.String s)
void	setIconColor(java.awt.Color $13)
void	setIconTextGap(int n)
void	setOpenProperty(java.lang.String $14)
void	setPadding(java.lang.String s)
void	setSize(java.awt.Dimension _d)
void	setSize(int _x, int _y)
void	setText(java.lang.String s)
void	setTextWhileLoading(java.lang.String $10)
void	setToolTipText(java.lang.String s)
void	setVAlign(java.lang.String s)
void	setVTextPosition(java.lang.String s)

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, callLog, cancelPendingRefreshRequests, checkEditable, checkVisible, evalScript, evalScript, evalScript, evalScript, evalScript, fhide, focusNextComponent, focusPreviousComponent, fshow, getActions, getActionsOfKind, getActionsOfKind, getBO, getConfRoot, getCtx, getDebugName, getDefaultActionMap, getFormActions, getFtx, getInstrumentedSchema, getLastRefreshRequest, getMaximumSize, getMinimumSize, getMissingPropertiesPolicy, getPreferredSize, getRefreshRequestsPending, getSchema, handleActionE, handleAttributes, handleDropAllowedIfE, handleEditableA, handleEditableIfE, handleElement, handleElements, handleElements, handleElements, handleImpliedA, handleMaximumSizeA, handleMaxSizeA, handleMinimumSizeA, handleMinSizeA, handleMissingPropertiesPolicyA, handleNameA, handleNewElement, handleNewElement, handleNewElement, handleOnAfterSaveE, handleOnAfterSetValueE, handleOnBeforeSaveE, handleOnBeforeSetValueE, handleOnConstructionE, handleOnDropE, handleOnFocusGainedE, handleOnFocusLostE, handleOnMDIActivateE, handleOnMDICloseE, handleOnMDIDeactivateE, handleOnMDIOpenE, handleOnRefreshE, handleOnSyncE, handlePreferredSizeA, handlePrefSizeA, handleScriptE, handleVirtualPropertyE, handleVisibleIfE, hasPreferredSizeOverride, invokeAction, invokeAction, isClosed, isDebug, isDefinedEditable, isEditable, isExplicitEditable, isGUIBuilt, isImpliedElement, isInputPossible, isShown, mdiActivate, mdiClose, mdiDeactivate, mdiOpen, postConstructor, postInit, postRefresh, processFocusVeto, processFocusVeto, queueDelayedRefresh, queueDelayedRefresh, reallyHandleVirtualPropertyE, refresh, refreshActions, refreshActions, registerActionImpl, registerFormAction, removeFormElementListener, requestFocus, requestFocusInWindow, 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, 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, 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, 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, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface de.ipcon.form.FormElementI

addFormElementListener, afterSave, afterSetValue, beforeSave, beforeSetValue, getActions, getActionsOfKind, getConfRoot, getCtx, getDebugName, getFtx, getName, getSchema, handleAttributes, handleElement, handleElements, handleNewElement, isClosed, isDebug, isEditable, isGUIBuilt, isInputPossible, isShown, mdiActivate, mdiClose, mdiDeactivate, mdiOpen, postInit, refresh, removeFormElementListener, requestFocus, setEditable, sync, toDebugName, willCareForChildActions, willCareForChildRefresh

Field Detail

myAttributes

public static java.util.HashMap myAttributes

myElements

public static java.util.HashMap myElements

Constructor Detail

FLabel

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

FLabel

public FLabel(FormContextI _ftx,
              electric.xml.Element _confroot,
              boolean _ignoreHandleAttributes)

Method Detail

getLabelComponent

public javax.swing.JLabel getLabelComponent()

close

public void close()

Specified by:

close in interface FormElementI

Overrides:

close in class FPanel

setSize

public void setSize(int _x,
                    int _y)

Overrides:

setSize in class java.awt.Component

setSize

public void setSize(java.awt.Dimension _d)

Overrides:

setSize in class java.awt.Component

setToolTipText

public void setToolTipText(java.lang.String s)

Overrides:

setToolTipText in class javax.swing.JComponent

setText

public void setText(java.lang.String s)

evaluateURL

public void evaluateURL(java.lang.String s)

checks if the provided (HTML-)String contains a URL, and if so, extracts the actual URL, and makes the jlabel clickable

setIcon

public void setIcon(java.lang.String s)

setDisabledIcon

public void setDisabledIcon(java.lang.String s)

setIconTextGap

public void setIconTextGap(int n)

setHAlign

public void setHAlign(java.lang.String s)

setVAlign

public void setVAlign(java.lang.String s)

setHTextPosition

public void setHTextPosition(java.lang.String s)

setVTextPosition

public void setVTextPosition(java.lang.String s)

setFont

public void setFont(java.lang.String s)

setFontStyle

public void setFontStyle(java.lang.String s)

setFontSize

public void setFontSize(java.lang.String s)

getFontSize

public java.lang.String getFontSize()

setPadding

public void setPadding(java.lang.String s)

handleArcA

public void handleArcA(electric.xml.Attribute a)

handleTextE

public void handleTextE(electric.xml.Element e)

handleClickableA

public void handleClickableA(electric.xml.Attribute a)

handleOpenPropertyA

public void handleOpenPropertyA(electric.xml.Attribute a)

handleIconColorA

public void handleIconColorA(electric.xml.Attribute a)

handleForegroundA

public void handleForegroundA(electric.xml.Attribute a)

handleBackgroundA

public void handleBackgroundA(electric.xml.Attribute a)

setGradientStartPosition

public void setGradientStartPosition(java.lang.String s)

setGradientStartColor

public void setGradientStartColor(java.lang.String s)

setGradientStartColor

public void setGradientStartColor(java.awt.Color c)

setGradientStopPosition

public void setGradientStopPosition(java.lang.String s)

setGradientStopColor

public void setGradientStopColor(java.lang.String s)

setGradientStopColor

public void setGradientStopColor(java.awt.Color c)

handlePropertyA

public void handlePropertyA(electric.xml.Attribute a)

handleFormatA

public void handleFormatA(electric.xml.Attribute a)

handleClassA

public void handleClassA(electric.xml.Attribute a)

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 FPanel

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 FPanel

Returns:

The element map.

buildGUI

public void buildGUI()

buildGUI

public void buildGUI(int pos)

refresh

public void refresh(int from)

Specified by:

refresh in interface FormElementI

Overrides:

refresh in class FPanel

calculationMightBeExpensive

public boolean calculationMightBeExpensive()

Overrides:

calculationMightBeExpensive in class FPanel

postRefresh

public void postRefresh()

Overrides:

postRefresh in class FPanel

postRefresh

public void postRefresh(int from)

Specified by:

postRefresh in interface FormElementI

Overrides:

postRefresh in class FPanel

setEnabled

public void setEnabled()

setEnabled

public void setEnabled(boolean b)

Overrides:

setEnabled in class javax.swing.JComponent

disable

public void disable()

Overrides:

disable in class javax.swing.JComponent

enable

public void enable()

Overrides:

enable in class javax.swing.JComponent

getBaseline

public int getBaseline(int width,
                       int height)

Overrides:

getBaseline in class javax.swing.JComponent

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

mouseClicked

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

Specified by:

mouseClicked in interface java.awt.event.MouseListener

actionPerformed

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

Specified by:

actionPerformed in interface java.awt.event.ActionListener

mouseEntered

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

Specified by:

mouseEntered in interface java.awt.event.MouseListener

mouseExited

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

Specified by:

mouseExited in interface java.awt.event.MouseListener

mousePressed

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

Specified by:

mousePressed in interface java.awt.event.MouseListener

mouseReleased

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

Specified by:

mouseReleased in interface java.awt.event.MouseListener

isRequestFocusEnabled

public boolean isRequestFocusEnabled()

Overrides:

isRequestFocusEnabled in class javax.swing.JComponent

getDisplayProperty

public java.lang.String getDisplayProperty()

Specified by:

getDisplayProperty in interface FormElementWithDisplayPropertyI

setDisplayProperty

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

getDisplayFormat

public java.lang.String getDisplayFormat()

setDisplayFormat

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

getTextWhileLoading

public java.lang.String getTextWhileLoading()

setTextWhileLoading

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

isHtml

public boolean isHtml()

setHtml

public void setHtml(boolean $11)

getAsyncRefresh

public java.lang.Boolean getAsyncRefresh()

setAsyncRefresh

public void setAsyncRefresh(java.lang.Boolean $12)

getIconColor

public java.awt.Color getIconColor()

setIconColor

public void setIconColor(java.awt.Color $13)

getOpenProperty

public java.lang.String getOpenProperty()

setOpenProperty

public void setOpenProperty(java.lang.String $14)