Package com.iizix.prop.ui
Interface IUIRadioComponent
- All Superinterfaces:
IComponent
,ICustomDataProvider
,IGProp<GProp<?>[]>
,IMessageBox
,IPropCnr
,IUIBooleanSelectionComp
,IUIComp
,IUIIndexedSelectionComp
,IUISelectionComp
,IUISingleIndexedSelectionComp
,IVSComponentListener
,IVSComponentState
,IVSFieldListener
- All Known Implementing Classes:
EUIRadioButton
,EUIRadioMenuItem
,UIRadioButton
,UIRadioMenuItem
public interface IUIRadioComponent extends IUIBooleanSelectionComp, IUISingleIndexedSelectionComp
Interface implemented by components that can be grouped together using a group name, e.g. radio buttons and radio button menu items.- Author:
- Christopher Mindus
Nested Class Summary
Nested classes/interfaces inherited from interface com.iizix.gyro.IMessageBox
IMessageBox.Icon
Nested classes/interfaces inherited from interface com.iizix.prop.vs.IVSComponentState
IVSComponentState.State
Field Summary
Fields Modifier and Type Field Description static java.lang.String
PN_GROUP_NAME
Property name: radio component group StringProp.static java.lang.String
PN_SELECTED
Property name: selected BoolProp.static java.lang.String
PN_SELECTED_NO_MATCH
Property name: selection for no match BoolProp.static java.lang.String
PN_SELECTED_VALUE
Property name: selected value.static Atom
SELECTED_ATOM
Property atom: selected BoolProp.Fields inherited from interface com.iizix.prop.IGProp
EQC_ERROR_IGNORE_ALL, EQC_ERROR_IGNORE_REFERENCES, EQC_IGNORE_ARRAY, EQC_IGNORE_VOLATILE_OR_EDITOR, EQC_PRIVATE, EQC_SAVE_FILE, EXT_CONTAINER_EXTENDS, EXT_CONTAINER_EXTENDS_VALID, EXT_EXTENDED, EXT_FINAL, EXT_OVERRIDES, EXT_OVERRIDES_FINAL_ERR, EXT_PRIVATE
Fields inherited from interface com.iizix.gyro.IMessageBox
ICON_ERROR, ICON_INFORMATION, ICON_MAP, ICON_NONE, ICON_QUESTION, ICON_WARNING
Fields inherited from interface com.iizix.prop.ui.IUIComp
ERROR, INFORMATION, NONE, REMOTE_FOCUS_EVENT, WARNING
Fields inherited from interface com.iizix.prop.ui.selection.IUISelectionComp
SELECTION_TYPE_MULTIPLE, SELECTION_TYPE_NONE, SELECTION_TYPE_SINGLE
Method Summary
All Methods Instance Methods Default Methods Modifier and Type Method Description default java.lang.String
clearSelection()
Clear the selection.default java.lang.String
getGroupName()
Gets the group name of the component.default UIComp[]
getRadioSelectionComponents()
Gets the components being part of the selection group.default int
getSelectedIndex()
Gets the first selected index.default int[]
getSelectedIndicies()
Gets the selected indicies.default UIComp
getSelectedRadioComponent()
Gets the currently selected radio component in the group.default RadioSelection
getSelection()
Gets the current selection of the component.default int
getSelectionType()
Gets the selection type of the component.default boolean
isOFF()
Returns if the selection is "off".default boolean
isON()
Returns if the selection is "on".default boolean
isSelected()
Returns the selection state.default boolean
isSelectedByDefault()
Checks if this radio component is selected by default in the group when selection doesn't match.default boolean
isUnselected()
Returns if the selection is not set.default boolean
setSelection(boolean on)
Sets the selection state.default java.lang.String
setSelection(int index)
Sets the selection as a single selected item at specified index.Methods inherited from interface com.iizix.IComponent
clearErrorMessage, getBadge, getKStringText, getLayoutMgr, getMessage, getMessageText, getStyles, getText, getTooltip, getTooltipText, getUIPanel, getUIParent, isEnabled, isReadOnly, isVisible, messageBox, requestFocus, requestFocus, requestFocusEx, requestFocusEx, setBadge, setBadge, setEnabled, setErrorMessage, setErrorMessage, setHTMLText, setLayoutMgr, setMessage, setMessage, setReadOnly, setText, setText, setTooltip, setTooltip, setVisible
Methods inherited from interface com.iizix.prop.ICustomDataProvider
forbiddenGetCustomDataMap, getCustomData, putCustomData, putCustomDataIfAbsent
Methods inherited from interface com.iizix.prop.IGProp
addPropError, addPropListener, dispose, equals, fine, fine, finer, finer, finest, finest, fromElementString, getAppSessionGyro, getAtomPath, getClientSessionGyro, getConstraints, getEnvironment, getErroredPropItems, getErroredProps, getErrorsProp, getExtendsRootContainer, getFullPropName, getFullPropNameDebug, getModuleFolder, getModuleFolder, getParent, getParent, getPropAtom, getPropBaseReference, getPropError, getPropError, getPropErrorSeverity, getPropExtendsFlags, getPropFromPath, getPropFromReference, getPropIndex, getPropName, getPropPath, getPropPath, getPropRootPropMgr, getPropTreeErrorSeverity, getPropValue, getPropValue, getReferencePropName, getReferences, getRelativePropName, getRootParent, getTreeLock, getValueClasses, getVSReference, hasChanged, hasPrivateChangeEventProp, hasPropError, hasPropTreeError, info, info, initializeGElement, initializeGProp, isDisposed, isPropChildOf, isPropClientCreated, isPropCommunicating, isPropCreateRequired, isPropExtended, isPropExtendsFinal, isPropExtendsPrivate, isPropExtendsPrivateInRoot, isPropExtendsPrivateInRoot, isPropFile, isPropFolder, isPropNullable, isPropPrivate, isPropReadOnly, isPropReferenceTreeValid, isPropRoot, isPropVirtualized, list, list, list, list, list, mapAliasToReference, mapReferenceToAlias, mapReferenceToProjectRelative, moveProp, moveProp, moveProp, onEvent, onEventSelf, onPropTreeInitialized, onRemoteEvent, removePropError, removePropListener, renameProp, resolveRuntimeReferences, setChanged, setConstraints, setConstraints, setParent, setPrivateChangeEventProp, setPropError, setPropExtendsFinal, setPropExtendsPrivate, setPropNullable, setPropPrivate, setPropReadOnly, setPropValue, setPropValue, severe, severe, severe, toElementString, toNativeValue, triggerRemoteEvent, triggerRemoteEvent, validateProp, validatePropType, validatePropValue, verify, verifyHasPropertyItem, warning, warning, warning
Methods inherited from interface com.iizix.gyro.IMessageBox
messageBox, messageBox
Methods inherited from interface com.iizix.prop.IPropCnr
addProp, addProp, addProp2, addProp2, canRequestFocus, canRequestFocus, canRequestFocus, containsProp, containsProp, couldRequestFocusIfVirtualized, couldRequestFocusIfVirtualized, couldRequestFocusIfVirtualized, createCopyOfAtom, createUniqueAtom, createUniqueAtom, enablePropCommunication, enablePropHashMap, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getBool, getBool, getBool, getBool, getChildPropError, getChildPropError, getChildPropErrorSeverity, getChildPropErrorSeverity, getErrorsProp, getExtendsError, getExtendsName, getExtendsPossibleClasses, getFirstProp, getFirstProp, getFocusEngine, getInt, getInt, getInt, getInt, getLong, getLong, getLong, getLong, getNumber, getNumber, getNumber, getNumber, getPossibleChildren, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getPropCnr, getPropCount, getPropIndex, getPropIndex, getPropIndexes, getProps, getProps, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getString, getString, getString, getString, hasFocus, initializeExtendsFramework, insertProp, insertProp2, isChild, isExtendsOverriden, isExtendsRoot, isPropAddRemoveAllowed, isPropExtended, isSibling, removeAllProps, removeAllProps2, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, reorderProps, requestFocus, requestFocusEx, setBool, setBool, setBool, setBool, setExtendsName, setExtendsOverride, setInt, setInt, setInt, setLong, setLong, setLong, setLong, setNumber, setNumber, setNumber, setNumber, setProp, setProp, setProp, setProp2, setProp2, setPropValue, setPropValue, setPropValue, setPropValue, setPropValue, setPropValue, setString, setString, setString, setString, usePropHashMap, usesPropIndex, validateClassInstances
Methods inherited from interface com.iizix.prop.ui.selection.IUIBooleanSelectionComp
isSelectionBooleanBased
Methods inherited from interface com.iizix.prop.ui.IUIComp
canAcceptUIContainerFocus, disconnectVSField, getComponentID, getComponentMappings, getDeviceType, getErrorMessage, getErrorMessage, getFirstUIComponent, getFirstUIComponentNull, getFixHeight, getFixWidth, getLayout, getLayoutMgr, getPanelUIComponent, getPanelUIComponentNull, getUIRef, getValue, getValue, getVirtualSpace, getVSField, isMobile, isRTL, isVSFieldDisconnected, reconnectVSField, setComponentToVSField, setErrorMessage, setErrorMessage, setUIContainerFocus, setVSFieldMessageToComponent, setVSFieldToComponent
Methods inherited from interface com.iizix.prop.ui.selection.IUIIndexedSelectionComp
isSelectionIndexBased, setSelection, setSelection, setSelection, setSelection, setSelection
Methods inherited from interface com.iizix.prop.ui.selection.IUISelectionComp
addSelectionListener, getOnUISelectionMethod, getSelectionListenerHandler, getSelectionPropAtom, isSelectionCellBased, isSelectionTriStateBased, removeSelectionListener, setSelection
Methods inherited from interface com.iizix.prop.ui.selection.IUISingleIndexedSelectionComp
getFirstSelectedIndex, setSelection
Methods inherited from interface com.iizix.prop.vs.IVSComponentListener
onParentStateChanged
Methods inherited from interface com.iizix.prop.vs.IVSFieldListener
getBestVSFieldValueType, onBroken, onResolved, onStateChanged, onValueChanged
Field Detail
PN_GROUP_NAME
static final java.lang.String PN_GROUP_NAME
Property name: radio component group StringProp.- See Also:
- Constant Field Values
PN_SELECTED
static final java.lang.String PN_SELECTED
Property name: selected BoolProp.- See Also:
- Constant Field Values
SELECTED_ATOM
static final Atom SELECTED_ATOM
Property atom: selected BoolProp.
PN_SELECTED_NO_MATCH
static final java.lang.String PN_SELECTED_NO_MATCH
Property name: selection for no match BoolProp.- See Also:
- Constant Field Values
PN_SELECTED_VALUE
static final java.lang.String PN_SELECTED_VALUE
Property name: selected value.- See Also:
- Constant Field Values
Method Detail
getGroupName
default java.lang.String getGroupName()
Gets the group name of the component.- Returns:
- The group name or null for none.
isSelected
default boolean isSelected()
Returns the selection state.- Specified by:
isSelected
in interfaceIUIBooleanSelectionComp
- Specified by:
isSelected
in interfaceIUISelectionComp
- Returns:
- true if the component is selected, false if unselected.
isUnselected
default boolean isUnselected()
Returns if the selection is not set.- Specified by:
isUnselected
in interfaceIUIBooleanSelectionComp
- Returns:
- true if unselected, false if selected.
isON
default boolean isON()
Returns if the selection is "on".- Specified by:
isON
in interfaceIUIBooleanSelectionComp
- Returns:
- true if on, false if off.
isOFF
default boolean isOFF()
Returns if the selection is "off".- Specified by:
isOFF
in interfaceIUIBooleanSelectionComp
- Returns:
- true if off, false if on.
getSelectedIndex
default int getSelectedIndex()
Gets the first selected index. For radio buttons and menu items, this means the index in the radio group. The ordering of the group is NOT related to the tab order, but rather the ordering they are found from container to children and so on.- Specified by:
getSelectedIndex
in interfaceIUISingleIndexedSelectionComp
- Returns:
- The first index in the current selection, or -1 for none.
getSelectedIndicies
default int[] getSelectedIndicies()
Gets the selected indicies. For radio buttons and menu items, this means the index in the radio group. The ordering of the group is NOT related to the tab order, but rather the ordering they are found from container to children and so on.- Specified by:
getSelectedIndicies
in interfaceIUIIndexedSelectionComp
- Specified by:
getSelectedIndicies
in interfaceIUISingleIndexedSelectionComp
- Returns:
- A new array of the selected indices (that may be modified to your liking), or a static zero in length array for no selection. The array is either of length 1 for one selection, or zero for none.
setSelection
default java.lang.String setSelection(int index)
Sets the selection as a single selected item at specified index.- Specified by:
setSelection
in interfaceIUIIndexedSelectionComp
- Parameters:
index
- The single item to select at index, -1 to clear the selection.- Returns:
- null for success, otherwise an error message why the selection failed.
clearSelection
default java.lang.String clearSelection()
Clear the selection.- Specified by:
clearSelection
in interfaceIUIIndexedSelectionComp
- Returns:
- null for OK.
isSelectedByDefault
default boolean isSelectedByDefault()
Checks if this radio component is selected by default in the group when selection doesn't match. Only one radio component in a group can return true with this method.- Returns:
- true if selected by default, false otherwise.
setSelection
default boolean setSelection(boolean on)
Sets the selection state.- Specified by:
setSelection
in interfaceIUIBooleanSelectionComp
- Parameters:
on
- The selection state.- Returns:
- true if state is changed, false for no change.
getRadioSelectionComponents
default UIComp[] getRadioSelectionComponents()
Gets the components being part of the selection group. Each component returned implements the this
interface.IUIRadioComponent
- Returns:
- An array of the selection components.
getSelectedRadioComponent
default UIComp getSelectedRadioComponent()
Gets the currently selected radio component in the group.- Returns:
- The selected radio component, null for none. The component implements this
interface.IUIRadioComponent
getSelectionType
default int getSelectionType()
Gets the selection type of the component.- Specified by:
getSelectionType
in interfaceIUISelectionComp
- Returns:
- A value indicating the selection capability as the SELECTION_TYPE_* values define.
getSelection
default RadioSelection getSelection()
Gets the current selection of the component.- Specified by:
getSelection
in interfaceIUISelectionComp
- Returns:
- The current selection of the component.