com.goldencode.p2j.ui.client.gui

Class RadioSetGuiImpl

java.lang.Object

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

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

com.goldencode.p2j.ui.client.LabeledPanel<O,RadioSetConfig>

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

com.goldencode.p2j.ui.client.gui.RadioSetGuiImpl

All Implemented Interfaces:

ControlSetComponent, DataContainer, FocusListener, LabeledWidget<GuiOutputManager>, MnemonicTrait<GuiOutputManager>, Container<GuiOutputManager>, Widget<GuiOutputManager>, WidgetWithConfig<RadioSetConfig>, ConfigOwner<RadioSetConfig>, java.awt.event.MouseListener, java.awt.event.MouseMotionListener, java.awt.event.MouseWheelListener, java.util.EventListener

public class RadioSetGuiImpl
extends RadioSet<GuiOutputManager>

RadioSet is a implementation of radio-set widget, a mutually exclusive set of RadioButton objects.

This is GUI specific implementation of the widget.

Field Summary

Fields

Modifier and Type	Field and Description
private CoordinatesConversion	cc Coordinate converter
private boolean	firstStateCheck Flag to keep track first time state check when widget become realized.
private GuiColorResolver	gc Color resolver
private GuiDriver	gd Screen driver
private GuiFontResolver	gf Font resolver
private int	rightPadding The padding of radio-buttons to the right-side.
private boolean	selecting Selection in progress flag.

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

buttons, current

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

config

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

listeners, location, mousePtr, nativeInsets, physicalLocation

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
protected void	adjustCurrentButton() Make the selected button the current one.
MnemonicInfo	createMnemonic() Creates new MnemonicInfoGuiImpl instance.
void	draw() Draws RadioSet widget in GUI mode.
private void	drawInt() Draws radio-set widget.
protected double	getButtonsExpandWidth(ControlSetItem[] items) Gets button width for expand mode.
protected double	getButtonsExtraDistance() Gets extra distance between radio-buttons.
protected double	getListHeightChars() Gets the list height in character units for radio-set.
protected double	getListWidthChars() Gets the list width in character units for radio-set.
private int	getRadioButtonIndex(java.awt.event.MouseEvent mEvt) Locates the radio-button index for the given mouse event coordinates inside radio-set.
(package private) int	getRightPadding() Get the right-padding width to be added to each button, in horizontal mode.
byte	getState() Gets the current state of this component's data.
double	height() Returns the height of the radio-set widget.
void	initialize(WidgetId id, RadioSetConfig 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.
boolean	isDroppable() Checks if the given widget is able to be the target of the drop operation.
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	mousePressed(java.awt.event.MouseEvent e) Notification of a mouse pressed event occurred for this widget.
void	processKeyEvent(KeyInput keyEvent) This overriding is used to move the focus from this widget to the next/previous one, rather than moving between radio buttons inside the current radio-set.
boolean	processMnemonic(int key) Process the given key, if this widget's mnemonic matches the key.
void	refreshItemsImpl(int selectedId, boolean selectedDisabled) Refresh widget look using new set of buttons, after the concrete implementation has done any other needed calculations.
boolean	supportsCustomMousePointer() Check if the widget supports LOAD-MOUSE-POINTER() method
double	width() Returns the width of the radio-set widget.

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

afterConfigUpdate, canMovetoTop, currentFocus, defaultFocus, focusTraversable, getCharWidth, getIndex, getSelected, getSelection, getText, getValue, getVisiblePart, isModified, manageSystemActions, onFocusGained, onFocusLost, reflectAncestorChange, refreshItems, reset, selectButton, setInitial, setValue, setWidthChars

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

config, destroy, getColon, getColumnLabelText, getColumnMnemonic, getLabelInstance, getLabelText, getMnemonic, getTo, isForceLabel, isNoLabels, isRightAligned, postprocessConfig, setColumnMnemonic, setHidden, setLabelInstance, setMnemonic, setNoLabels, setVisible, setWasVisible, wasVisible

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

add, add, add, addContainerStateListener, addDirectly, belongsTo, checkWidget, childrenLocation, clipping, clipRectangle, copyState, currentFocus, cycleFocus, deregisterSelectedWidget, detach, dimension, doLayout, dumpCurrentWidgets, dumpWidgets, endSizeChange, findMouseSource, firstFocus, focus, focusWorker, formatDump, get, getAllSelectedWidgets, getClipRect, getEffectiveScrollableSize, getFocusInt, getIgnoreFocus, getLayout, getScrollableSize, getTabItemList, hasFocusable, insets, lastFocus, minimumSize, moveAfterTabItem, moveBeforeTabItem, moveToBottom, moveToBottomInClass, moveToTop, moveToTopInClass, moveToZpos, nextFocus, normalizeZOrder, onWidgetAdded, onWidgetRemoved, paintOnTop, parentOf, prepareWidgets, prevFocus, reflectLocationChanged, registerSelectedWidget, remove, removeContainerStateListener, repaint, 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, ancestor, ancestorId, autoResize, bounds, clear, clearWidget, clipRectangle, clipRectangle, clipWith, copyColors, createMouseHoverAction, deactivateDirectManipulation, debug, disable, disableTooltip, displayPhysicalLocation, drawCaret, enable, enableTooltip, enclosingFrame, forceCursorOnFocus, forceVisibility, getActualBounds, getAndResetBitmap, getAndSetBitmap, getBitmapCopy, getCachedScreenLocation, getCachedScreenPhysicalLocation, getCustomMousePointer, getDefaultEvent, getEffectiveMousePointer, getId, getLoadedMousePointer, getMenuMouse, getMouseActions, getMousePosition, getPortableMouseEventCoordinates, getSelectedText, getTextHeight, getTextHeightNative, getTextHeightNative, getTextWidth, getTextWidth, getTextWidthNative, getTextWidthNative, getZOrderClass, hasFocus, hasTooltip, hidden, hide, highlighted, ignoreAction, initialHeight, initialWidth, isCurrent, isDirectManipulationActive, isDirectManipulationActiveOrInUIB, isDirectManipulationCapable, isDirectManipulationRequired, isDisplayed, isEnabled, isFocusable, isHeader, isMouseDrag, isRealized, isRepaintDisabled, isRMBEntrySupported, isScreenLocationCached, isTabStop, isThreeD, isTotallyObscured, isVisible, isVisible, location, mouseDragged, mouseEntered, mouseExited, mouseMoved, mouseReleased, mouseWheelMoved, moveToBottom, moveToTop, name, navigable, oleDoDrop, oleDrag, oleDragging, oleStartDragging, onOleDragging, onOleDropEnd, parent, parent, parentObject, parentOrSelf, parentOrSelfObject, physicalBounds, physicalDimension, physicalLocation, prepParentLocation, preventFocusWhenMouseDownEventDefined, processDirectManipulationEvent, processEvent, processFocusEvent, processKeyEventForSelectableWidget, processKeyListeners, 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, setHighlighted, setLocation, setLocation, setMousePointer, setMousePointer, setParent, setPhysicalLocation, setSensitiveForUIB, setState, setWindow, show, showPopupMenu, sync, topLevelWindow, toString, 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.DataContainer

getChangedValue

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

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

Methods inherited from interface java.awt.event.MouseListener

mouseEntered, mouseExited, 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.MnemonicTrait

getMnemonicCharacter, getMnemonicKeyCode, getMnemonicLabel, isMnemonicSupported, updateMnemonic

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

widgetsAsList

Field Detail

gd

private GuiDriver gd

Screen driver

gc

private GuiColorResolver gc

Color resolver

gf

private GuiFontResolver gf

Font resolver

cc

private CoordinatesConversion cc

Coordinate converter

selecting

private boolean selecting

Selection in progress flag.

firstStateCheck

private boolean firstStateCheck

Flag to keep track first time state check when widget become realized.

rightPadding

private int rightPadding

The padding of radio-buttons to the right-side.

Constructor Detail

RadioSetGuiImpl

public RadioSetGuiImpl(WidgetId id,
                       WidgetConfig cfg)

Special constructor used to restore component using given configuration.

Call initialize(com.goldencode.p2j.ui.WidgetId, com.goldencode.p2j.ui.RadioSetConfig) to finish the widget initialization.

Parameters:

id - The widget's ID.

cfg - Configuration data.

Method Detail

initialize

public void initialize(WidgetId id,
                       RadioSetConfig 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<RadioSetConfig>

Overrides:

initialize in class RadioSet<GuiOutputManager>

Parameters:

id - The widget's ID.

cfg - The config used to initialize this widget.

refreshItemsImpl

public void refreshItemsImpl(int selectedId,
                             boolean selectedDisabled)

Refresh widget look using new set of buttons, after the concrete implementation has done any other needed calculations.

In GUI, this computes the right-padding to be added to each radio-button.

Overrides:

refreshItemsImpl in class RadioSet<GuiOutputManager>

Parameters:

selectedId - The selected button ID; -1 if none selected.

selectedDisabled - Flag indicating if the selected button is disabled.

getState

public byte getState()

Gets the current state of this component's data.

Specified by:

getState in interface Widget<GuiOutputManager>

Overrides:

getState in class AbstractWidget<GuiOutputManager>

Returns:

The state of this widget's data (for example ScreenBuffer.UNINITIALIZED).

width

public double width()

Returns the width of the radio-set widget.

Specified by:

width in interface Widget<GuiOutputManager>

Overrides:

width in class AbstractContainer<GuiOutputManager>

Returns:

The radio-set width value.

height

public double height()

Returns the height of the radio-set widget.

Specified by:

height in interface Widget<GuiOutputManager>

Overrides:

height in class AbstractContainer<GuiOutputManager>

Returns:

The radio-set height value.

draw

public void draw()

Draws RadioSet widget in GUI mode.

Specified by:

draw in interface Widget<GuiOutputManager>

Overrides:

draw in class RadioSet<GuiOutputManager>

processMnemonic

public boolean processMnemonic(int key)

Process the given key, if this widget's mnemonic matches the key.

Specified by:

processMnemonic in interface Widget<GuiOutputManager>

Overrides:

processMnemonic in class AbstractWidget<GuiOutputManager>

Parameters:

key - The pressed mnemonic key code.

Returns:

true if this widget accepted this mnemonic key. Not enabled or not visible widget will not accept it.

createMnemonic

public MnemonicInfo createMnemonic()

Creates new MnemonicInfoGuiImpl instance.

Returns:

MnemonicInfoGuiImpl instance.

processKeyEvent

public void processKeyEvent(KeyInput keyEvent)

This overriding is used to move the focus from this widget to the next/previous one, rather than moving between radio buttons inside the current radio-set.

Specified by:

processKeyEvent in interface Widget<GuiOutputManager>

Overrides:

processKeyEvent in class RadioSet<GuiOutputManager>

Parameters:

keyEvent - The key event to be processed.

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.

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.

mouseActions

protected int[] mouseActions()

Determine the mouse actions processed by this widget.

Overrides:

mouseActions in class AbstractWidget<GuiOutputManager>

Returns:

See above.

supportsCustomMousePointer

public boolean supportsCustomMousePointer()

Check if the widget supports LOAD-MOUSE-POINTER() method

Specified by:

supportsCustomMousePointer in interface Widget<GuiOutputManager>

Overrides:

supportsCustomMousePointer in class AbstractWidget<GuiOutputManager>

Returns:

true if the widget supports LOAD-MOUSE-POINTER() method

isDroppable

public boolean isDroppable()

Checks if the given widget is able to be the target of the drop operation.

Returns:

TRUE if this widget can be droppable at this time, FALSE otherwise.

getButtonsExpandWidth

protected double getButtonsExpandWidth(ControlSetItem[] items)

Gets button width for expand mode.

Overrides:

getButtonsExpandWidth in class RadioSet<GuiOutputManager>

Parameters:

items - Radio-button set to check.

Returns:

The GUI dependent button width for expand mode.

getButtonsExtraDistance

protected double getButtonsExtraDistance()

Gets extra distance between radio-buttons.

Overrides:

getButtonsExtraDistance in class RadioSet<GuiOutputManager>

Returns:

The GUI dependent distance between buttons.

getListHeightChars

protected double getListHeightChars()

Gets the list height in character units for radio-set.

Overrides:

getListHeightChars in class RadioSet<GuiOutputManager>

Returns:

The GUI dependent height for item list.

getListWidthChars

protected double getListWidthChars()

Gets the list width in character units for radio-set.

Overrides:

getListWidthChars in class RadioSet<GuiOutputManager>

Returns:

The GUI dependent width for item list.

adjustCurrentButton

protected void adjustCurrentButton()

Make the selected button the current one.

Overrides:

adjustCurrentButton in class RadioSet<GuiOutputManager>

getRightPadding

int getRightPadding()

Get the right-padding width to be added to each button, in horizontal mode.

Returns:

The rightPadding value.

drawInt

private void drawInt()

Draws radio-set widget. Internal wodker.

getRadioButtonIndex

private int getRadioButtonIndex(java.awt.event.MouseEvent mEvt)

Locates the radio-button index for the given mouse event coordinates inside radio-set.

Parameters:

mEvt - The mouse event to be checked.

Returns:

The radio-button that contains the point with given X,Y or null if none.