Package docking.actions

Interface SharedDockingActionPlaceholder

  • public interface SharedDockingActionPlaceholder
    A marker interface to signal that the implementing action serves as an action that should not be itself used in the tool, but should only be used to register and manager keybindings.

    This action is merely a tool by which transient components can ensure that their actions are correctly managed when the component is created. Normal actions will get registered when the tool first starts-up. Alternatively, transient components only appear when called upon by some event, such as a user request. The issue heretofore was that the tool will remove any options that are not longer used. Thus, if an action belonging to a transient component does not get registered every time the tool is used, then the options (and key bindings) for that action are removed from the too. This interface allows a second-party to register an action on behalf of a transient provider, thus preventing the tool from removing any previously applied options.

    • Method Detail

      • getName

        java.lang.String getName()
        The action name. This name must exactly match the name of the action represented by this placeholder.
        Returns:
        the name

      • getOwner

        default java.lang.String getOwner()
        Returns an owner name to use in place of "Shared". This should only be used when the client knows for certain that all shared actions are shared by a single owner. This is not typical for shared actions. This can happen when one owner (such as a plugin) has multiple component providers that share action key bindings.
        Returns:
        the owner

      • getKeyBinding

        default javax.swing.KeyStroke getKeyBinding()
        The default key binding for the action represented by this placeholder
        Returns:
        the key binding; may be null