Package docking.actions

# Interface PopupActionProvider

All Known Implementing Classes:
  `ListingMergePanelProvider`

public interface PopupActionProvider
Provides notification when the popup action menu is displayed. This interface allows temporary/transient actions (those not registered with the tool via `Tool.addAction(DockingActionIf)`) to be used in the popup context menu.

Most clients will register actions directly with the tool. However, clients that have numerous actions that vary greatly with the context can use this method to only create those actions on demand as the popup is about to be shown, and only if their context is active. This mechanism can reduce the tool's action management overhead. Once you have created an implementation of this class, you must register it with `Tool.addPopupActionProvider(PopupActionProvider)`.

- ## Method Summary

  Modifier and Type
  Method
  Description
  `List<DockingActionIf>`
  `getPopupActions(Tool tool, ActionContext context)`
  Provides notification that the popup menu is about to be displayed and allows a set of temporary actions to be included in the popup menu.

- ## Method Details

  - ### getPopupActions

    List<DockingActionIf> getPopupActions(Tool tool, ActionContext context)
    Provides notification that the popup menu is about to be displayed and allows a set of temporary actions to be included in the popup menu. Actions returned will be included in the menu if they have a valid popup menu path and respond true to the `DockingActionIf.isValidContext(ActionContext)` call.
    Parameters:
      `tool` - the tool requesting the actions
      `context` - the ActionContext
    Returns:
      list of temporary popup actions; return null if there are no popup actions