com.goldencode.p2j.ui.client.gui

Class SubMenuGuiImpl

java.lang.Object

com.goldencode.p2j.ui.client.widget.AbstractWidget<O>

com.goldencode.p2j.ui.client.widget.AbstractContainer<O>

com.goldencode.p2j.ui.client.SubMenu<GuiOutputManager>

com.goldencode.p2j.ui.client.gui.SubMenuGuiImpl

All Implemented Interfaces:

FocusListener, MenuElement<GuiOutputManager>, MenuStructure<GuiOutputManager>, Container<GuiOutputManager>, Widget<GuiOutputManager>, WidgetWithConfig<SubMenuConfig>, ConfigOwner<SubMenuConfig>, java.awt.event.MouseListener, java.awt.event.MouseMotionListener, java.awt.event.MouseWheelListener, java.util.EventListener

public class SubMenuGuiImpl
extends SubMenu<GuiOutputManager>
implements FocusListener

SubMenu client abstract implementation class.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private class	SubMenuGuiImpl.SubMenuBody Sub-menu body.

Field Summary

Fields

Modifier and Type	Field and Description
private SubMenuGuiImpl.SubMenuBody	body The sub-menu body container.
private boolean	bodySwitch When a submenu overlay window is opened while another submenu is opened, do not activate the parent submenu's overlay window.
private double	cachedHeight Cached height of this item.
private double	cachedWidth Cached width of this item.
private GuiDriver	gd Screen driver
private GuiFontResolver	gf Font resolver
(package private) static int	HEIGHT_PAD This menu-item top/bottom padding in a MENUBAR, in pixels.
private static int	HIDE_SHOW_MENUBAR_MS_DELAY Default delay time to show/hide submenu body for menubar items in milliseconds.
private static int	HIDE_SHOW_MS_DELAY Default delay time to show/hide submenu body in milliseconds if not specified in config.
private static int	menuDelayMS Configurable menu delay time in milliseconds.
private boolean	mousePressedToShowBody Flag to indicate whether the mouse has been pressed to show the body.
private static java.util.concurrent.ScheduledFuture<?>	sf Scheduled task for show/hide workers.
private static java.util.concurrent.ScheduledExecutorService	srvPopUp Executor service for show/hide workers.
(package private) static int	WIDTH_PAD This menu-item minimum left/righ padding in a MENUBAR, in pixels.

Fields inherited from class com.goldencode.p2j.ui.client.SubMenu

config, showBody

Fields inherited from class com.goldencode.p2j.ui.client.widget.AbstractWidget

listeners, location, mousePtr, nativeInsets, physicalLocation

Constructor Summary

Constructors

Constructor and Description
SubMenuGuiImpl(WidgetId id, SubMenuConfig cfg) Special constructor used to restore component using given configuration.

Method Summary

Modifier and Type	Method and Description
protected Dimension	bodyDimension() Calculates body dimension
protected Point	bodyLocation() Get location of SUB-MENU body, relative to container.
Point	childrenLocation(Widget<GuiOutputManager> child) Get children location for one child.
(package private) static void	clearHighlights(Container<GuiOutputManager> container) Clears highlighted flag for all child menu elements.
(package private) static SubMenuGuiImpl	createDynamicSubmenu(java.lang.String title) Create a dynamic submenu with the specified title.
protected MnemonicInfo	createLabelInfo() Creates new MnemonicInfo instance
Widget<GuiOutputManager>	currentFocus() Get widget which is in focus.
Widget<GuiOutputManager>	defaultFocus() Get default focusable widget.
void	destroy() Destroy this widget.
private void	detachFromPopupWindow() Detaches this widget from the parent body widget.
void	doLayout() Lay out container.
void	draw() Draw the peer container.
Widget<GuiOutputManager>	findMouseSource(NativePoint p) Find the widget positioned just bellow the specified mouse position (in physical units).
MenuStructure<GuiOutputManager>	getBody() Returns the submenu body instance.
Widget<GuiOutputManager>	getFocusInt() Get focused widget.
static int	getLongestItemAccelWidth(Container<?> menu, GuiFontResolver gf, GuiDriver<?,?> gd) Calculates max menu/sub-menu item accelerator width.
static int	getLongestItemTitleWidth(Container<?> menu, MenuElement<?> exclude, GuiFontResolver gf, GuiDriver<?,?> gd) Calculates max menu/sub-menu item title (config's) width.
static double	getMaxSubMenuHeight(AbstractContainer<?> menu) Calculates a max height of specified Menu or SubMenu including borders.
static double	getMaxSubMenuItemWidth(Container<?> menu, boolean includeNested) Calculates max menu/sub-menu item width with borders
double	height() Get sub-menu height.
(package private) static void	hideBodies(Container<GuiOutputManager> container, SubMenuGuiImpl exclude, boolean bodySwitch) Recursively hides all the sub-menu bodies starting at the passed in container reference down.
(package private) static void	hideBodiesWithDelay(Container<GuiOutputManager> container, SubMenuGuiImpl exclude) Recursively hides all the sub-menu bodies starting at this sub-menu.
void	hideBody(boolean recursiveUp) Hides sub-menu body.
void	initialize(WidgetId id, SubMenuConfig cfg) Replacement API for the logic which should exist in the widget's c'tor, but the logic can't be executed as it depends on the widget being registered into the official registry.
void	invalidateCachedSize() Invalidate the cached size of this item.
protected boolean	isBodyDisplayed() Returns the boolean, denoting is body displayed or not.
boolean	isBodySwitch() Returns the body switch state.
boolean	isLegacyFocus() Returns a flag marking the widget as subject to legacy focus handling.
protected void	menuDropEvents(boolean fromMnemonic) Raise the MENU-DROP 4GL events.
protected int[]	mouseActions() Determine the mouse actions processed by this widget.
void	mouseClicked(java.awt.event.MouseEvent e) Notification of a mouse clicked event occurred for this widget.
void	mouseEntered(java.awt.event.MouseEvent e) Notification of a mouse entered event occurred for this widget.
void	mouseExited(java.awt.event.MouseEvent e) Notification of a mouse exited event occurred for this widget.
void	mousePressed(java.awt.event.MouseEvent e) Notification of a mouse pressed event occurred for this widget.
boolean	navigable() Returns true only if this widget is navigable using mouse.
void	onFocusGained(FocusEvent event) This method is invoked when focus is gained.
void	onFocusLost(FocusEvent event) This method is invoked when focus is lost.
private void	openSubmenuBody() Opens submenu body immediately or delayed.
protected java.util.List<Widget<GuiOutputManager>>	prepareWidgets(java.util.List<Widget<GuiOutputManager>> widgets) Prepare widgets before drawing
protected Point	prepParentLocation(Widget<?> parent) Trick, that lets to correct parent location in cases, when it needed, for example for menus.
void	processKeyEvent(KeyInput event) Process key event.
void	resetBody() Hard reset sub menu internal to initial state.
void	setVisible(boolean visible) Hide/show widget.
protected void	showBody() Shows this sub-menu body.
private static void	stopScheduledShowHide() Cancels the scheduled task if one exists.
static double	titleHeight(AbstractContainer<?> menu) Gets sub-menu title height
static double	titleHeightWithBorders(AbstractContainer<?> menu) Gets sub-menu title height, considering border padding.
double	titleWidth() Gets sub-menu title width (with '->' if sub-menu is in other sub-menu or in popup menu) Borders are not included.
double	titleWidthWithBorders() Gets sub-menu title width (with '->' if sub-menu is in other sub-menu or in popup menu) If SUBMENU is not MENUBAR element, then calculate longest neighbor.
java.lang.String	toString() Returns a string representation of the object.
double	width() Get widget width with borders.

Methods inherited from class com.goldencode.p2j.ui.client.SubMenu

afterConfigUpdate, ancestor, config, currentFocus, focusTraversable, focusWorker, forceCursorOnFocus, getFirstFocusableItem, getFocusedChild, getLastFocusableItem, getPreparedLabel, getPreparedTitle, hasChildSubmenu, isEnabled, isShowBody, manageSystemActions, processMnemonicEvent, repaint, requestFocus, setInitialFocus

Methods inherited from class com.goldencode.p2j.ui.client.widget.AbstractContainer

add, add, add, addContainerStateListener, addDirectly, belongsTo, checkWidget, clipping, clipRectangle, copyState, cycleFocus, deregisterSelectedWidget, detach, dimension, dumpCurrentWidgets, dumpWidgets, endSizeChange, firstFocus, focus, formatDump, get, getAllSelectedWidgets, getClipRect, getEffectiveScrollableSize, getIgnoreFocus, getLayout, getScrollableSize, getTabItemList, hasFocusable, insets, lastFocus, minimumSize, moveAfterTabItem, moveBeforeTabItem, moveToBottom, moveToBottomInClass, moveToTop, moveToTopInClass, moveToZpos, nextFocus, normalizeZOrder, onWidgetAdded, onWidgetRemoved, paintOnTop, parentOf, prevFocus, reflectAncestorChange, reflectLocationChanged, registerSelectedWidget, remove, removeContainerStateListener, replace, requestFocus, requestFocus, setFocus, setFocusInt, setHeight, setIgnoreFocus, setInsets, setLayout, setPhysicalDimensionInt, setSize, setSize, setTabItemList, setWidth, startSizeChange, swap, triggerContainerStateRedrawEnabled, unrealize, updateSizeWorker, widgets, widgetsAsList, widgetStateChanged

Methods inherited from class com.goldencode.p2j.ui.client.widget.AbstractWidget

_setHidden, _setVisible, activateDirectManipulation, addFocusListener, addKeyListener, afterConfigUpdateBase, ancestorId, autoResize, bounds, clear, clearWidget, clipRectangle, clipRectangle, clipWith, copyColors, createMouseHoverAction, deactivateDirectManipulation, debug, disable, disableTooltip, displayPhysicalLocation, drawCaret, enable, enableTooltip, enclosingFrame, forceVisibility, getActualBounds, getAndResetBitmap, getAndSetBitmap, getBitmapCopy, getCachedScreenLocation, getCachedScreenPhysicalLocation, getCustomMousePointer, getDefaultEvent, getEffectiveMousePointer, getId, getLoadedMousePointer, getMenuMouse, getMouseActions, getMousePosition, getPortableMouseEventCoordinates, getSelectedText, getState, getTextHeight, getTextHeightNative, getTextHeightNative, getTextWidth, getTextWidth, getTextWidthNative, getTextWidthNative, getVisiblePart, getZOrderClass, hasFocus, hasTooltip, hidden, hide, highlighted, ignoreAction, initialHeight, initialWidth, isCurrent, isDirectManipulationActive, isDirectManipulationActiveOrInUIB, isDirectManipulationCapable, isDirectManipulationRequired, isDisplayed, isFocusable, isHeader, isMouseDrag, isRealized, isRepaintDisabled, isRMBEntrySupported, isScreenLocationCached, isTabStop, isThreeD, isTotallyObscured, isVisible, isVisible, location, mouseDragged, mouseMoved, mouseReleased, mouseWheelMoved, moveToBottom, moveToTop, name, oleDoDrop, oleDrag, oleDragging, oleStartDragging, onOleDragging, onOleDropEnd, parent, parent, parentObject, parentOrSelf, parentOrSelfObject, physicalBounds, physicalDimension, physicalLocation, postprocessConfig, preventFocusWhenMouseDownEventDefined, processDirectManipulationEvent, processEvent, processFocusEvent, processKeyEventForSelectableWidget, processKeyListeners, processMnemonic, processMnemonicImpl, processSystemKey, raiseLegacyMouseEvents, reflectSizeChanged, refresh, registerWidgetListener, repaint, repaint, requestSync, resetBitmap, resizeTo, resolveFont, resolvePopupMenuId, resolveTitleFont, screen, screenDimension, screenHeight, screenLocation, screenPhysicalLocation, screenWidth, setBitmap, setCachedScreenLocation, setCachedScreenPhysicalLocation, setDirectManipulationActive, setEnabled, setHidden, setHighlighted, setLocation, setLocation, setMousePointer, setMousePointer, setParent, setPhysicalLocation, setSensitiveForUIB, setState, setWindow, show, showPopupMenu, supportsCustomMousePointer, sync, topLevelWindow, translate, triggerLocationChanged, unregisterWidgetListener, updateSystemParent, widgetRealized, window

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.goldencode.p2j.ui.client.MenuStructure

getParentMenu, getParentMenuContainer, getParentSubMenu, getParentSubMenuBody, getRootSubMenu

Methods inherited from interface com.goldencode.p2j.ui.client.widget.Widget

acceptsEscAsAnyKey, acceptTrigger, addFocusListener, addKeyListener, ancestorId, bounds, canMovetoTop, clearWidget, completeTrigger, defaultMousePtr, dimension, displayPhysicalLocation, drawCaret, enclosingFrame, enforceDefaultMousePtr, forceVisibility, getActualBounds, getCustomMousePointer, getEffectiveMousePointer, getId, getIdForTrigger, getLegacyWidget, getLoadedMousePointer, getMenuMouse, getMouseActions, getMousePosition, getSelectedText, getState, getTriggerWidget, getTriggerWidget, getVisiblePart, getZOrderClass, hasFocus, hasFocus, hasTooltip, hidden, hide, highlighted, ignoreEnable, initialHeight, initialWidth, insets, isCurrent, isCurrent, isDirectManipulable, isDirectManipulationActive, isDirectManipulationActiveOrInUIB, isDisplayed, isDroppable, isFocusable, isHeader, isInitialValueLayout, isProcessProgressEvent, isRealized, isRepaintDisabled, isRMBEntrySupported, isTabStop, isThreeD, isTotallyObscured, isVisible, isVisible, location, maySwitchFocus, minimumSize, moveToBottom, moveToTop, name, oleDrag, parent, parent, parent, parentObject, parentOrSelf, parentOrSelfObject, physicalBounds, physicalDimension, physicalLocation, postprocessConfig, preventFocusWhenMouseDownEventDefined, processDirectManipulationEvent, processEvent, processFocusEvent, processKeyListeners, processMnemonic, raiseLegacyMouseEvents, refreshWidget, registerWidgetListener, repaint, repaint, requestFocus, requestFocus, requestSync, resizeTo, resolvePopupMenuId, screen, screenLocation, screenPhysicalLocation, setDirectManipulationActive, setEnabled, setHidden, setHighlighted, setLocation, setLocation, setMousePointer, setMousePointer, setParent, setPhysicalLocation, setSensitiveForUIB, setState, setWindow, show, startTrigger, supportsCustomMousePointer, systemFocusGrabbed, topLevelWindow, unrealize, unregisterWidgetListener, validateDisplayValue, widgetStateChanged, window

Methods inherited from interface java.awt.event.MouseListener

mouseReleased

Methods inherited from interface java.awt.event.MouseMotionListener

mouseDragged, mouseMoved

Methods inherited from interface java.awt.event.MouseWheelListener

mouseWheelMoved

Methods inherited from interface com.goldencode.p2j.ui.client.widget.Container

widgetsAsList

Field Detail

HEIGHT_PAD

static final int HEIGHT_PAD

This menu-item top/bottom padding in a MENUBAR, in pixels.

See Also:

Constant Field Values

WIDTH_PAD

static final int WIDTH_PAD

This menu-item minimum left/righ padding in a MENUBAR, in pixels.

See Also:

Constant Field Values

HIDE_SHOW_MS_DELAY

private static final int HIDE_SHOW_MS_DELAY

Default delay time to show/hide submenu body in milliseconds if not specified in config.

See Also:

Constant Field Values

HIDE_SHOW_MENUBAR_MS_DELAY

private static final int HIDE_SHOW_MENUBAR_MS_DELAY

Default delay time to show/hide submenu body for menubar items in milliseconds.

See Also:

Constant Field Values

srvPopUp

private static java.util.concurrent.ScheduledExecutorService srvPopUp

Executor service for show/hide workers.

sf

private static java.util.concurrent.ScheduledFuture<?> sf

Scheduled task for show/hide workers.

menuDelayMS

private static int menuDelayMS

Configurable menu delay time in milliseconds.

gd

private GuiDriver gd

Screen driver

gf

private GuiFontResolver gf

Font resolver

body

private SubMenuGuiImpl.SubMenuBody body

The sub-menu body container.

cachedWidth

private double cachedWidth

Cached width of this item. If 0 or negative, value is invalidated and need re-computed.

cachedHeight

private double cachedHeight

Cached height of this item. If 0 or negative, value is invalidated and need re-computed.

bodySwitch

private boolean bodySwitch

When a submenu overlay window is opened while another submenu is opened, do not activate the parent submenu's overlay window. This creates an unwanted window z-order change flickering effect.

mousePressedToShowBody

private boolean mousePressedToShowBody

Flag to indicate whether the mouse has been pressed to show the body. If set to true, it means that the user has pressed the mouse button to trigger the action of showing the body. If set to false, it means that the user has not performed this action yet.

Constructor Detail

SubMenuGuiImpl

public SubMenuGuiImpl(WidgetId id,
                      SubMenuConfig cfg)

Special constructor used to restore component using given configuration.

Parameters:

id - The widget's ID.

cfg - Configuration data.

Method Detail

hideBodies

static void hideBodies(Container<GuiOutputManager> container,
                       SubMenuGuiImpl exclude,
                       boolean bodySwitch)

Recursively hides all the sub-menu bodies starting at the passed in container reference down. This method doesn't work for popup menus, use hideBody(boolean) instead.

Parameters:

container - The reference container.

exclude - The SubMenu item to exclude.

bodySwitch - Pass true to make this hide bodies request part of another submenu body showing up.

hideBodiesWithDelay

static void hideBodiesWithDelay(Container<GuiOutputManager> container,
                                SubMenuGuiImpl exclude)

Recursively hides all the sub-menu bodies starting at this sub-menu. The bodies are hidden with the sub-menu close/open delay.

Parameters:

container - The reference container.

exclude - The SubMenu item to exclude.

clearHighlights

static void clearHighlights(Container<GuiOutputManager> container)

Clears highlighted flag for all child menu elements.

Parameters:

container - The reference container.

createDynamicSubmenu

static SubMenuGuiImpl createDynamicSubmenu(java.lang.String title)

Create a dynamic submenu with the specified title.

Parameters:

title - The title of the submenu.

Returns:

a submenu.

getLongestItemAccelWidth

public static int getLongestItemAccelWidth(Container<?> menu,
                                           GuiFontResolver gf,
                                           GuiDriver<?,?> gd)

Calculates max menu/sub-menu item accelerator width.

Parameters:

menu - Parent container: MENU or SUB-MENU.

gf - Font resolver.

gd - Gui driver.

Returns:

max accelerator width.

getLongestItemTitleWidth

public static int getLongestItemTitleWidth(Container<?> menu,
                                           MenuElement<?> exclude,
                                           GuiFontResolver gf,
                                           GuiDriver<?,?> gd)

Calculates max menu/sub-menu item title (config's) width.

Parameters:

menu - Parent container: MENU or SUB-MENU.

exclude - Current menu item, to exclude from processing.

gf - Font resolver.

gd - Gui driver.

Returns:

max title width in pixels.

getMaxSubMenuHeight

public static double getMaxSubMenuHeight(AbstractContainer<?> menu)

Calculates a max height of specified Menu or SubMenu including borders. Analyzes nested dropped-down sub-menus.

Parameters:

menu - Menu or SubMenu.

Returns:

a height of menu.

getMaxSubMenuItemWidth

public static double getMaxSubMenuItemWidth(Container<?> menu,
                                            boolean includeNested)

Calculates max menu/sub-menu item width with borders

Parameters:

menu - MENU or SUB-MENU

includeNested - true means, that we should process nested sub-menus, false otherwise.

Returns:

max width.

titleHeight

public static double titleHeight(AbstractContainer<?> menu)

Gets sub-menu title height

Parameters:

menu - The parent MENU or SUB-MENU widget.

Returns:

height of sub-menu title

titleHeightWithBorders

public static double titleHeightWithBorders(AbstractContainer<?> menu)

Gets sub-menu title height, considering border padding.

Parameters:

menu - The parent MENU or SUB-MENU widget.

Returns:

height of sub-menu title

initialize

public void initialize(WidgetId id,
                       SubMenuConfig cfg)

Replacement API for the logic which should exist in the widget's c'tor, but the logic can't be executed as it depends on the widget being registered into the official registry.

This API is called after the widget is created and added to the registry.

Specified by:

initialize in interface WidgetWithConfig<SubMenuConfig>

Overrides:

initialize in class SubMenu<GuiOutputManager>

Parameters:

id - The widget's ID.

cfg - The config used to initialize this widget.

getBody

public MenuStructure<GuiOutputManager> getBody()

Returns the submenu body instance.

Returns:

See above.

mouseActions

protected int[] mouseActions()

Determine the mouse actions processed by this widget.

Overrides:

mouseActions in class AbstractWidget<GuiOutputManager>

Returns:

See above.

defaultFocus

public Widget<GuiOutputManager> defaultFocus()

Get default focusable widget.

Specified by:

defaultFocus in interface Container<GuiOutputManager>

Overrides:

defaultFocus in class SubMenu<GuiOutputManager>

Returns:

default focusable widget.

currentFocus

public Widget<GuiOutputManager> currentFocus()

Get widget which is in focus.

Specified by:

currentFocus in interface Container<GuiOutputManager>

Overrides:

currentFocus in class AbstractContainer<GuiOutputManager>

Returns:

focused widget.

doLayout

public void doLayout()

Lay out container. Set children locations.

Specified by:

doLayout in interface Container<GuiOutputManager>

Overrides:

doLayout in class AbstractContainer<GuiOutputManager>

draw

public void draw()

Draw the peer container. The methods calls the draw() method for ScrollPane instance for the peer container. In addition the required clipping rectangle is calculated for ChildFrame containers because they must be rendered inside the parent container.

Drawing for the redirected terminal differs. Labels/headers are drawn only once per page, instead of the usual once per menu.

Specified by:

draw in interface Widget<GuiOutputManager>

Overrides:

draw in class AbstractContainer<GuiOutputManager>

isLegacyFocus

public boolean isLegacyFocus()

Returns a flag marking the widget as subject to legacy focus handling. The value is used by focus manager and adjusts its logic accordingly.

Specified by:

isLegacyFocus in interface Widget<GuiOutputManager>

Returns:

See above.

isBodySwitch

public boolean isBodySwitch()

Returns the body switch state.

Returns:

See above.

invalidateCachedSize

public void invalidateCachedSize()

Invalidate the cached size of this item. This way, the next time the height/width is requested it is automatically re calculated using new environment.

width

public double width()

Get widget width with borders.

Specified by:

width in interface Widget<GuiOutputManager>

Overrides:

width in class AbstractContainer<GuiOutputManager>

Returns:

widget width.

height

public double height()

Get sub-menu height.

Specified by:

height in interface Widget<GuiOutputManager>

Overrides:

height in class AbstractContainer<GuiOutputManager>

Returns:

sub-menu height.

hideBody

public void hideBody(boolean recursiveUp)

Hides sub-menu body.

Overrides:

hideBody in class SubMenu<GuiOutputManager>

Parameters:

recursiveUp - true means hide body for all parent sub-menus.

titleWidth

public double titleWidth()

Gets sub-menu title width (with '->' if sub-menu is in other sub-menu or in popup menu) Borders are not included.

Specified by:

titleWidth in class SubMenu<GuiOutputManager>

Returns:

width of sub-menu title

titleWidthWithBorders

public double titleWidthWithBorders()

Gets sub-menu title width (with '->' if sub-menu is in other sub-menu or in popup menu) If SUBMENU is not MENUBAR element, then calculate longest neighbor.

Returns:

width of sub-menu title

navigable

public boolean navigable()

Returns true only if this widget is navigable using mouse.

Specified by:

navigable in interface Widget<GuiOutputManager>

Overrides:

navigable in class AbstractWidget<GuiOutputManager>

Returns:

true if widget is navigable using mouse.

processKeyEvent

public void processKeyEvent(KeyInput event)

Process key event.

Specified by:

processKeyEvent in interface Widget<GuiOutputManager>

Overrides:

processKeyEvent in class SubMenu<GuiOutputManager>

Parameters:

event - Key event to process.

mouseClicked

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

Notification of a mouse clicked event occurred for this widget.

Specified by:

mouseClicked in interface java.awt.event.MouseListener

Overrides:

mouseClicked in class AbstractWidget<GuiOutputManager>

Parameters:

e - The mouse event.

mouseEntered

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

Notification of a mouse entered event occurred for this widget.

Specified by:

mouseEntered in interface java.awt.event.MouseListener

Overrides:

mouseEntered in class AbstractWidget<GuiOutputManager>

Parameters:

e - The mouse event.

mouseExited

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

Notification of a mouse exited event occurred for this widget.

Specified by:

mouseExited in interface java.awt.event.MouseListener

Overrides:

mouseExited in class AbstractWidget<GuiOutputManager>

Parameters:

e - The mouse event.

mousePressed

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

Notification of a mouse pressed event occurred for this widget.

Specified by:

mousePressed in interface java.awt.event.MouseListener

Overrides:

mousePressed in class AbstractWidget<GuiOutputManager>

Parameters:

e - The mouse event.

findMouseSource

public Widget<GuiOutputManager> findMouseSource(NativePoint p)

Find the widget positioned just bellow the specified mouse position (in physical units). Each container should search for own widgets. Because widgets are relative positioned inside containers the container physical position is adjusted before search.

Specified by:

findMouseSource in interface Widget<GuiOutputManager>

Overrides:

findMouseSource in class AbstractContainer<GuiOutputManager>

Parameters:

p - The mouse physical location.

Returns:

A widget over which the mouse is positioned or null if none found.

childrenLocation

public Point childrenLocation(Widget<GuiOutputManager> child)

Get children location for one child.

Specified by:

childrenLocation in interface Container<GuiOutputManager>

Overrides:

childrenLocation in class AbstractContainer<GuiOutputManager>

Parameters:

child - Child component.

Returns:

Point - parents location

onFocusGained

public void onFocusGained(FocusEvent event)

This method is invoked when focus is gained.

Specified by:

onFocusGained in interface FocusListener

Parameters:

event - Event which triggered this call.

onFocusLost

public void onFocusLost(FocusEvent event)

This method is invoked when focus is lost. If current focus is on in subtree of this sub-menu, than hide body.

Specified by:

onFocusLost in interface FocusListener

Parameters:

event - Event which triggered this call.

setVisible

public void setVisible(boolean visible)

Hide/show widget.

Specified by:

setVisible in interface Widget<GuiOutputManager>

Overrides:

setVisible in class SubMenu<GuiOutputManager>

Parameters:

visible - New visible state.

toString

public java.lang.String toString()

Returns a string representation of the object.

Overrides:

toString in class AbstractWidget<GuiOutputManager>

Returns:

A string representation of the object.

destroy

public void destroy()

Destroy this widget. Notify all of its components that the widget has been destroyed.

Specified by:

destroy in interface Widget<GuiOutputManager>

Overrides:

destroy in class AbstractContainer<GuiOutputManager>

getFocusInt

public Widget<GuiOutputManager> getFocusInt()

Get focused widget.

Overrides:

getFocusInt in class AbstractContainer<GuiOutputManager>

Returns:

focused widget.

createLabelInfo

protected MnemonicInfo createLabelInfo()

Creates new MnemonicInfo instance

Overrides:

createLabelInfo in class SubMenu<GuiOutputManager>

Returns:

MnemonicInfo or its descendant.

menuDropEvents

protected void menuDropEvents(boolean fromMnemonic)

Raise the MENU-DROP 4GL events.

Specified by:

menuDropEvents in class SubMenu<GuiOutputManager>

Parameters:

fromMnemonic - Flag which indicates that the generated menu drop event is caused my a key event (mnemonic). This is used by the event processor to detect if the first element of the menu should be focused or not.

prepParentLocation

protected Point prepParentLocation(Widget<?> parent)

Trick, that lets to correct parent location in cases, when it needed, for example for menus.

Overrides:

prepParentLocation in class AbstractWidget<GuiOutputManager>

Parameters:

parent - Parent component - must be a sub-menu.

Returns:

corrected parent location.

bodyLocation

protected Point bodyLocation()

Get location of SUB-MENU body, relative to container.

Specified by:

bodyLocation in class SubMenu<GuiOutputManager>

Returns:

body location.

bodyDimension

protected Dimension bodyDimension()

Calculates body dimension

Specified by:

bodyDimension in class SubMenu<GuiOutputManager>

Returns:

Dimension

prepareWidgets

protected java.util.List<Widget<GuiOutputManager>> prepareWidgets(java.util.List<Widget<GuiOutputManager>> widgets)

Prepare widgets before drawing

Overrides:

prepareWidgets in class AbstractContainer<GuiOutputManager>

Parameters:

widgets - Container children.

Returns:

widgets, prepared for drawing.

showBody

protected void showBody()

Shows this sub-menu body.

In GUI, it also registers it for "any" actions, so that it is notified when a click occurs outside of its boundaries.

Overrides:

showBody in class SubMenu<GuiOutputManager>

isBodyDisplayed

protected boolean isBodyDisplayed()

Returns the boolean, denoting is body displayed or not.

Returns:

true if body is displayed, false - otherwise.

stopScheduledShowHide

private static void stopScheduledShowHide()

Cancels the scheduled task if one exists.

openSubmenuBody

private void openSubmenuBody()

Opens submenu body immediately or delayed.

resetBody

public void resetBody()

Hard reset sub menu internal to initial state. Use with caution bevause it makes recursive calls to walk through all sub menus in the current item.

detachFromPopupWindow

private void detachFromPopupWindow()

Detaches this widget from the parent body widget.