|
Eclipse Platform Release 3.1 |
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.eclipse.debug.ui.actions.ContextualLaunchAction
An action delegate that builds a context menu with applicable launch shortcuts for a specific launch mode.
This class can be subclassed and contributed as an object contribution pop-up menu extension action. When invoked, it becomes a sub-menu that dynamically builds a list of applicable launch shortcuts for the current selection. Each launch shortcut may have optional information to support a context menu action.
Clients may subclass this class.
Constructor Summary | |
---|---|
ContextualLaunchAction(String mode)
Constructs a contextual launch action for the given launch mode. |
Method Summary | |
---|---|
void |
dispose()
Disposes the menu returned by getMenu . |
protected void |
fillMenu(Menu menu)
Fills the menu with applicable launch shortcuts |
Menu |
getMenu(Control parent)
Returns the SWT menu, created as a pop up menu parented by the given control. |
Menu |
getMenu(Menu parent)
Returns an SWT menu created as a drop down menu parented by the given menu. |
void |
run(IAction action)
Performs this action. |
void |
selectionChanged(IAction action,
ISelection selection)
Notifies this action delegate that the selection in the workbench has changed. |
void |
setActivePart(IAction action,
IWorkbenchPart targetPart)
Sets the active part for the delegate. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public ContextualLaunchAction(String mode)
mode
- launch modeMethod Detail |
public void setActivePart(IAction action, IWorkbenchPart targetPart)
IObjectActionDelegate
This method will be called every time the action appears in a popup menu. The targetPart may change with each invocation.
setActivePart
in interface IObjectActionDelegate
action
- the action proxy that handles presentation portion of the actiontargetPart
- the new part targetpublic void dispose()
IMenuCreator
getMenu
. Does nothing
if there is no menu. This method will be executed only when the
parent of the menu is disposed.
dispose
in interface IMenuCreator
public Menu getMenu(Control parent)
IMenuCreator
getMenu
in interface IMenuCreator
parent
- the parent control
null
if the menu could not
be createdpublic Menu getMenu(Menu parent)
IMenuCreator
getMenu
in interface IMenuCreator
parent
- the parent menu
null
if the menu could not
be createdpublic void run(IAction action)
IActionDelegate
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.
run
in interface IActionDelegate
action
- the action proxy that handles the presentation portion of the
actionpublic void selectionChanged(IAction action, ISelection selection)
IActionDelegate
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.
selectionChanged
in interface IActionDelegate
action
- the action proxy that handles presentation portion of
the actionselection
- the current selection, or null
if there
is no selection.protected void fillMenu(Menu menu)
menu
- The menu to fill
|
Eclipse Platform Release 3.1 |
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Guidelines for using Eclipse APIs.
Copyright (c) IBM Corp. and others 2000, 2005. All rights reserved.