Interface ILockUI
- All Known Subinterfaces:
IUIAction
- All Known Implementing Classes:
AbstractUIAction
,EditorVSAction
,EMLItemProp
,EUIButton
,EUIImage
,EUIMenuItem
,MLItemProp
,UIButton
,UIImage
,UIMenuItem
,VSAction
public interface ILockUI extends IPropCnr
Interface providing Lock UI API support used by UI and VirtualSpace actions.- Author:
- Christopher Mindus
Field Summary
Fields Modifier and Type Field Description static java.lang.String
LOCK_UI
Property name: lock UI, BoolProp, default true.static java.lang.String
WAIT_MSG
Property name: wait message, KStringProp.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
Method Summary
All Methods Instance Methods Default Methods Modifier and Type Method Description default ProgressIndicatorDelay
getProgressIndicatorDelay()
Returns the delay before the hourglass is shown when the UI is locked.default ProgressIndicatorDelay
getProgressIndicatorDelay(ILockUI defaultProvider)
Returns the delay before the hourglass is shown when the UI is locked.default KString
getWaitMessage()
Returns the wait message to display alongside the UI lock or progress indicator in the UI (e.g.default KString
getWaitMessage(ILockUI defaultProvider)
Returns the wait message to display alongside the UI lock or progress indicator in the UI (e.g.default boolean
isLockUIEnabled()
Returns if the action would lock the UI before execution.default boolean
isLockUIEnabled(ILockUI defaultProvider)
Returns if the action would lock the UI before execution.default boolean
setLockUIEnabled(boolean doLockUI)
Sets if the action should lock the UI before the action starts execution.default boolean
setProgressIndicatorDelay(ProgressIndicatorDelay delay)
Sets the delay before the hourglass is shown when the UI is locked.default boolean
setWaitMessage(KString waitMsg)
Returns the wait message to display alongside the UI lock or progress indicator in the UI (e.g.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.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
Field Detail
LOCK_UI
static final java.lang.String LOCK_UI
Property name: lock UI, BoolProp, default true.- See Also:
- Constant Field Values
WAIT_MSG
static final java.lang.String WAIT_MSG
Property name: wait message, KStringProp.- See Also:
- Constant Field Values
Method Detail
isLockUIEnabled
default boolean isLockUIEnabled()
Returns if the action would lock the UI before execution.If the UI is not locked, the user could still perform functions in it. Generally this is not a good idea, but sometimes actions can perform some lengthy operation with a progress feed-back.
The default is true.
- Returns:
- true if the UI lock state for the application session should be set or activated, false otherwise.
getWaitMessage
default KString getWaitMessage()
Returns the wait message to display alongside the UI lock or progress indicator in the UI (e.g. spinning hourglass).- Returns:
- The wait message, or null for none (just the hourglass is displayed).
getProgressIndicatorDelay
default ProgressIndicatorDelay getProgressIndicatorDelay()
Returns the delay before the hourglass is shown when the UI is locked.- Returns:
- The delay, never null, default NORMAL.
isLockUIEnabled
default boolean isLockUIEnabled(ILockUI defaultProvider)
Returns if the action would lock the UI before execution.The returned value is taken from this instance if defined, otherwise from the defaultProvider (if defined).
If the UI is not locked, the user could still perform functions in it. Generally this is not a good idea, but sometimes actions can perform some lengthy operation with a progress feed-back.
- Parameters:
defaultProvider
- If the setting is not provided by this instance and thedefaultProvider
is not null, use its default value if the setting is undefined.- Returns:
- true if the UI lock state for the application session should be set or activated, false otherwise.
getWaitMessage
default KString getWaitMessage(ILockUI defaultProvider)
Returns the wait message to display alongside the UI lock or progress indicator in the UI (e.g. spinning hourglass).The returned value is taken from this instance if defined, otherwise from the defaultProvider (if defined).
- Parameters:
defaultProvider
- If the setting is not provided by this instance and thedefaultProvider
is not null, use its default value if the setting is undefined.- Returns:
- The wait message, or null for none (just the hourglass is displayed).
getProgressIndicatorDelay
default ProgressIndicatorDelay getProgressIndicatorDelay(ILockUI defaultProvider)
Returns the delay before the hourglass is shown when the UI is locked.The returned value is taken from this instance if defined, otherwise from the defaultProvider (if defined).
- Parameters:
defaultProvider
- If the setting is not provided by this instance and thedefaultProvider
is not null, use its default value if the setting is undefined.- Returns:
- The delay, never null, default NORMAL.
setLockUIEnabled
default boolean setLockUIEnabled(boolean doLockUI)
Sets if the action should lock the UI before the action starts execution.If the UI is not locked, the user could still perform functions in it. Generally this is not a good idea, but sometimes actions can perform some lengthy operation with a progress feed-back.
- Parameters:
doLockUI
- The UI lock state.- Returns:
- true if the value was changed, false otherwise.
setWaitMessage
default boolean setWaitMessage(KString waitMsg)
Returns the wait message to display alongside the UI lock or progress indicator in the UI (e.g. spinning hourglass).- Parameters:
waitMsg
- The wait message, or null or empty for none (just the hourglass is displayed).- Returns:
- true if the value was changed, false otherwise.
setProgressIndicatorDelay
default boolean setProgressIndicatorDelay(ProgressIndicatorDelay delay)
Sets the delay before the hourglass is shown when the UI is locked.- Parameters:
delay
- The delay, never null.- Returns:
- true if the value was changed, false otherwise.