Package org.eclipse.debug.ui.actions

Class AbstractLaunchHistoryAction

    • Field Detail

      • fRecreateMenu

        protected boolean fRecreateMenu
        Indicates whether the launch history has changed and the sub menu needs to be recreated.

    • Constructor Detail

      • AbstractLaunchHistoryAction

        public AbstractLaunchHistoryAction​(String launchGroupIdentifier)
        Constructs a launch history action.
        Parameters:
        launchGroupIdentifier - unique identifier of the launch group extension that this action displays a launch history for.

    • Method Detail

      • getAction

        protected IAction getAction()
        Returns the action used to render this delegate.
        Returns:
        the action used to render this delegate

      • addToMenu

        protected void addToMenu​(Menu menu,
                         IAction action,
                         int accelerator)
        Adds the given action to the specified menu with an accelerator specified by the given number.
        Parameters:
        menu - the menu to add the action to
        action - the action to add
        accelerator - the number that should appear as an accelerator

      • updateTooltip

        protected void updateTooltip()
        Updates this action's tool-tip. The tooltip is based on user preference settings for launching - either the previous launch, or based on the selection and which configuration will be launched.

        Subclasses may override as required.

      • getToolTip

        protected String getToolTip​(ILaunchConfiguration configuration)
        Returns the tooltip specific to a configuration.
        Parameters:
        configuration - a ILauncConfiguration
        Returns:
        the string for the tool tip

      • launchHistoryChanged

        public void launchHistoryChanged()
        Description copied from interface: org.eclipse.debug.internal.ui.ILaunchHistoryChangedListener
        Notification that the launch history has changed. Any of the run history, debug history or last launched items could have changed. To examine the history items, retrieve them from the DebugUIPlugin.
        Specified by:
        launchHistoryChanged in interface org.eclipse.debug.internal.ui.ILaunchHistoryChangedListener
        See Also:
        ILaunchHistoryChangedListener.launchHistoryChanged()

      • getLastLaunch

        protected ILaunchConfiguration getLastLaunch()
        Return the last launch in this action's launch history.
        Returns:
        the most recent configuration that was launched from this action's launch history that is not filtered from the menu

      • getMenu

        public Menu getMenu​(Menu parent)
        Description copied from interface: IWorkbenchWindowPulldownDelegate2
        Returns the menu for this pull down action. This method will only be called if the user opens the pull down menu for the action. Note that it is the responsibility of the implementor to properly dispose of any SWT menus created by this method.
        Specified by:
        getMenu in interface IWorkbenchWindowPulldownDelegate2
        Parameters:
        parent - the menu to work with
        Returns:
        the menu

      • fillMenu

        protected void fillMenu​(Menu menu)
        Fills the drop-down menu with favorites and launch history
        Parameters:
        menu - the menu to fill

      • addSeparator

        protected void addSeparator​(Menu menu)
        Adds a separator to the given menu
        Parameters:
        menu - the menu to add the separator to

      • run

        public void run​(IAction action)
        Description copied from interface: IActionDelegate
        Performs this action.

        This method is called by the proxy action when the action has been triggered. Implement this method to do the actual work.

        Note: If the action delegate also implements IActionDelegate2, then this method is not invoked but instead the runWithEvent(IAction, Event) method is called.

        Specified by:
        run in interface IActionDelegate
        Parameters:
        action - the action proxy that handles the presentation portion of the action
        See Also:
        IActionDelegate.run(org.eclipse.jface.action.IAction)

      • runInternal

        protected void runInternal​(IAction action,
                           boolean isShift)
        Since:
        3.12

      • init

        public void init​(IAction action)
        Description copied from interface: IActionDelegate2
        Allows the action delegate to initialize itself after being created by the proxy action. This lifecycle method is called after the action delegate has been created and before any other method of the action delegate is called.
        Specified by:
        init in interface IActionDelegate2
        Parameters:
        action - the proxy action that handles the presentation portion of the action.
        Since:
        3.6
        See Also:
        IActionDelegate2.init(org.eclipse.jface.action.IAction)

      • selectionChanged

        public void selectionChanged​(IAction action,
                             ISelection selection)
        Description copied from interface: IActionDelegate
        Notifies this action delegate that the selection in the workbench has changed.

        Implementers can use this opportunity to change the availability of the action or to modify other presentation properties.

        When the selection changes, the action enablement state is updated based on the criteria specified in the plugin.xml file. Then the delegate is notified of the selection change regardless of whether the enablement criteria in the plugin.xml file is met.

        Specified by:
        selectionChanged in interface IActionDelegate
        Parameters:
        action - the action proxy that handles presentation portion of the action
        selection - the current selection, or null if there is no selection.
        See Also:
        IActionDelegate.selectionChanged(org.eclipse.jface.action.IAction, org.eclipse.jface.viewers.ISelection)

      • getLaunchHistory

        @Deprecated
protected org.eclipse.debug.internal.ui.launchConfigurations.LaunchHistory getLaunchHistory()
        Deprecated.
        this method returns a class that is not API and is not intended for clients of the debug platform. Instead, use getHistory(), getFavorites(), and getLastLaunch().
        Returns the launch history associated with this action's launch group.
        Returns:
        the launch history associated with this action's launch group

      • getHistory

        protected ILaunchConfiguration[] getHistory()
        Returns the launch history associated with this action's launch mode and group in most recently launched order. Configurations associated with disabled activities are not included in the list. As well, configurations are filtered based on workspace preference settings to filter configurations from closed projects, deleted projects, working sets and to filter specific launch configuration types.
        Returns:
        launch history
        Since:
        3.3

      • getFavorites

        protected ILaunchConfiguration[] getFavorites()
        Returns the launch favorites associated with this action's launch mode and group in user preference order. Configurations associated with disabled activities are not included in the list. As well, configurations are filtered based on workspace preference settings to filter configurations from closed projects, deleted projects, working sets and to filter specific launch configuration types.
        Returns:
        favorite launch configurations
        Since:
        3.3

      • getMode

        protected String getMode()
        Returns the mode (e.g., 'run' or 'debug') of this drop down.
        Returns:
        the mode of this action

      • getLaunchGroupIdentifier

        protected String getLaunchGroupIdentifier()
        Returns the identifier of the launch group this action is associated with.
        Returns:
        the identifier of the launch group this action is associated with