Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Programming
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Databases
Mail Systems
openSolaris
Eclipse Documentation
Techotopia.com
Virtuatopia.com

How To Guides
Virtualization
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Windows
Problem Solutions
Privacy Policy

  




 

 


Eclipse Platform
Release 3.5

org.eclipse.debug.ui.actions
Class ContextualLaunchAction

java.lang.Object
  extended by 
org.eclipse.debug.ui.actions.ContextualLaunchAction
All Implemented Interfaces:
IMenuCreator, IActionDelegate, IObjectActionDelegate

public abstract class ContextualLaunchAction
extends Object
implements IObjectActionDelegate, IMenuCreator

An action delegate that builds a context menu with applicable launch shortcuts for a specific launch mode.

This class can be sub-classed 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.

Since:
3.0

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
protected   ILaunchManager getLaunchManager ()
          Returns the launch manager
  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

ContextualLaunchAction

public ContextualLaunchAction(
String mode)
Constructs a contextual launch action for the given launch mode.

Parameters:
mode - launch mode
Method Detail

setActivePart

public void setActivePart(
IAction action,
                          
IWorkbenchPart targetPart)
Description copied from interface: IObjectActionDelegate
Sets the active part for the delegate. The active part is commonly used to get a working context for the action, such as the shell for any dialog which is needed.

This method will be called every time the action appears in a popup menu. The targetPart may change with each invocation.

Specified by:
setActivePart in interface IObjectActionDelegate
Parameters:
action - the action proxy that handles presentation portion of the action; must not be null.
targetPart - the new part target; must not be null.

dispose

public void dispose()
Description copied from interface: IMenuCreator
Disposes the menu returned by getMenu. Does nothing if there is no menu. This method will be executed only when the parent of the menu is disposed.

Specified by:
dispose in interface IMenuCreator

getMenu

public 
Menu getMenu(
Control parent)
Description copied from interface: IMenuCreator
Returns the SWT menu, created as a pop up menu parented by the given control. In most cases, this menu can be created once, cached and reused when the pop-up/drop-down action occurs. If the menu must be dynamically created (i.e., each time it is popped up or dropped down), the old menu should be disposed of before replacing it with the new menu.

Specified by:
getMenu in interface IMenuCreator
Parameters:
parent - the parent control
Returns:
the menu, or null if the menu could not be created

getMenu

public 
Menu getMenu(
Menu parent)
Description copied from interface: IMenuCreator
Returns an SWT menu created as a drop down menu parented by the given menu. In most cases, this menu can be created once, cached and reused when the pop-up/drop-down action occurs. If the menu must be dynamically created (i.e., each time it is popped up or dropped down), the old menu should be disposed of before replacing it with the new menu.

Specified by:
getMenu in interface IMenuCreator
Parameters:
parent - the parent menu
Returns:
the menu, or null if the menu could not be created

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

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.

getLaunchManager

protected 
ILaunchManager getLaunchManager()
Returns the launch manager

Returns:
the launch manager
Since:
3.3

fillMenu

protected void fillMenu(
Menu menu)
Fills the menu with applicable launch shortcuts

Parameters:
menu - The menu to fill

Eclipse Platform
Release 3.5

Guidelines for using Eclipse APIs.

Copyright (c) Eclipse contributors and others 2000, 2008. All rights reserved.


 
 
  Published under the terms of the Eclipse Public License Version 1.0 ("EPL") Design by Interspire