Package com.iizix.prop.ui
Interface IUICheckComponent
- All Superinterfaces:
IComponent
,ICustomDataProvider
,IGProp<GProp<?>[]>
,IMessageBox
,IPropCnr
,IUIComp
,IUISelectionComp
,IUITriStateSelectionComp
,IVSComponentListener
,IVSComponentState
,IVSFieldListener
- All Known Implementing Classes:
EUICheckBox
,EUICheckedMenuItem
,UICheckBox
,UICheckedMenuItem
public interface IUICheckComponent extends IUITriStateSelectionComp
Components with check state implement this interface.- 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 Atom
CHECKED_ATOM
Property atom: checked.static java.lang.String
PN_CHECK_NO_MATCH
Property name: check state for non-matching values.static java.lang.String
PN_CHECKED
Property name: checked.static java.lang.String
PN_CHECKED_VALUE
Property name: checked value.static java.lang.String
PN_UNCHECKED_VALUE
Property name: unchecked value.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 int
getCheckState()
Gets the check state.default IUITriStateSelection
getSelection()
Gets the current selection of the component.default int
getSelectionType()
Gets the selection type of the component.default boolean
isChecked()
Verifies if the component is checked.default boolean
isSelected()
Returns the selection of state of the component.default boolean
isSelectionTriStateBased()
Returns if the selection component supports tri-state based selection for e.g.default boolean
isThirdState()
Returns if the state is third state, i.e.default boolean
isUnselected()
Returns if the state is unselected.default boolean
setChecked(boolean on)
Sets the checked state.default boolean
setChecked(int state)
Sets the checked state.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.IUIComp
canAcceptUIContainerFocus, disconnectVSField, getComponentID, getComponentMappings, getContainerFirstUIComponent, getContainerFirstUIComponentNull, 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.IUISelectionComp
addSelectionListener, getOnUISelectionMethod, getSelectionListenerHandler, getSelectionPropAtom, isSelectionBooleanBased, isSelectionCellBased, isSelectionIndexBased, removeSelectionListener, 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_CHECKED
static final java.lang.String PN_CHECKED
Property name: checked.- See Also:
- Constant Field Values
CHECKED_ATOM
static final Atom CHECKED_ATOM
Property atom: checked.
PN_CHECKED_VALUE
static final java.lang.String PN_CHECKED_VALUE
Property name: checked value.- See Also:
- Constant Field Values
PN_UNCHECKED_VALUE
static final java.lang.String PN_UNCHECKED_VALUE
Property name: unchecked value.- See Also:
- Constant Field Values
PN_CHECK_NO_MATCH
static final java.lang.String PN_CHECK_NO_MATCH
Property name: check state for non-matching values.- See Also:
- Constant Field Values
Method Detail
getCheckState
default int getCheckState()
Gets the check state.- Specified by:
getCheckState
in interfaceIUITriStateSelectionComp
- Returns:
- Returns 0={$link com.iizix.prop.ui.IUITriStateSelection#UNSELECTED}, 1={$link com.iizix.prop.ui.IUITriStateSelection#CHECKED} or 2={$link com.iizix.prop.ui.IUITriStateSelection#THIRD_STATE}.
isChecked
default boolean isChecked()
Verifies if the component is checked.- Specified by:
isChecked
in interfaceIUITriStateSelectionComp
- Returns:
- true if the component is checked, false if unselected or in third state.
setChecked
default boolean setChecked(boolean on)
Sets the checked state.- Specified by:
setChecked
in interfaceIUITriStateSelectionComp
- Parameters:
on
- The check state.- Returns:
- true if state is changed, false for no change.
setChecked
default boolean setChecked(int state)
Sets the checked state.If a component has a VirtualSpace connection, setting the third state will not have any effect. This since it would create an inconsistent state of the component.
- Specified by:
setChecked
in interfaceIUITriStateSelectionComp
- Parameters:
state
- The check state: 0=unchecked, 1=checked, 2=third state.- Returns:
- true if state is changed, false for no change or failure (state has wrong value).
isSelected
default boolean isSelected()
Returns the selection of state of the component.For a multiple-selection capable component, this indicates any selection, i.e. true is returned as soon as at least one element is selected, false for none.
The checkbox for example has two "selected states": checked and third state: in this case, true is returned for the third state as well as the checked state.
- Specified by:
isSelected
in interfaceIUISelectionComp
- Returns:
- true if the component is selected, false otherwise.
isUnselected
default boolean isUnselected()
Returns if the state is unselected.- Returns:
- true if unchecked, false if checked or in third state.
isThirdState
default boolean isThirdState()
Returns if the state is third state, i.e. neither checked nor unselected.- Returns:
- true if third state, false if checked or unselected.
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 IUITriStateSelection getSelection()
Gets the current selection of the component.- Specified by:
getSelection
in interfaceIUISelectionComp
- Returns:
- The current selection of the component.
isSelectionTriStateBased
default boolean isSelectionTriStateBased()
Returns if the selection component supports tri-state based selection for e.g. checkboxes.- Specified by:
isSelectionTriStateBased
in interfaceIUISelectionComp
- Returns:
- true.