Interface ILockUI

All Superinterfaces:
IGProp<GProp<?>[]>, IPropCnr
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 Details

  • Method Details

    • 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 the defaultProvider 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 the defaultProvider 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 the defaultProvider 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.