Eclipse Platform
Release 3.1

org.eclipse.debug.ui.actions
Class OpenLaunchDialogAction

java.lang.Object
  extended byorg.eclipse.jface.action.Action
      extended byorg.eclipse.debug.ui.actions.OpenLaunchDialogAction
All Implemented Interfaces:
IAction, IActionDelegate, IWorkbenchWindowActionDelegate

public class OpenLaunchDialogAction
extends Action
implements IWorkbenchWindowActionDelegate

Opens the launch configuration dialog in the context of a launch group.

Clients are not intended to subclass this class; clients may instantiate this class.

Since:
2.1

Field Summary
 
Fields inherited from interface org.eclipse.jface.action.IAction
AS_CHECK_BOX, AS_DROP_DOWN_MENU, AS_PUSH_BUTTON, AS_RADIO_BUTTON, AS_UNSPECIFIED, CHECKED, DESCRIPTION, ENABLED, HANDLED, IMAGE, RESULT, TEXT, TOOL_TIP_TEXT
 
Constructor Summary
OpenLaunchDialogAction(String identifier)
          Constructs an action that opens the launch configuration dialog in the context of the specified launch group.
 
Method Summary
 void dispose()
          Disposes this action delegate.
 void init(IWorkbenchWindow window)
          Initializes this action delegate with the workbench window it will work in.
 void run()
          The default implementation of this IAction method does nothing.
 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.
 
Methods inherited from class org.eclipse.jface.action.Action
addPropertyChangeListener, convertAccelerator, convertAccelerator, findKeyCode, findKeyString, findModifier, findModifierString, firePropertyChange, firePropertyChange, getAccelerator, getActionDefinitionId, getDescription, getDisabledImageDescriptor, getHelpListener, getHoverImageDescriptor, getId, getImageDescriptor, getMenuCreator, getStyle, getText, getToolTipText, isChecked, isEnabled, isHandled, notifyResult, removeAcceleratorText, removeMnemonics, removePropertyChangeListener, runWithEvent, setAccelerator, setActionDefinitionId, setChecked, setDescription, setDisabledImageDescriptor, setEnabled, setHelpListener, setHoverImageDescriptor, setId, setImageDescriptor, setMenuCreator, setText, setToolTipText
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

OpenLaunchDialogAction

public OpenLaunchDialogAction(String identifier)
Constructs an action that opens the launch configuration dialog in the context of the specified launch group.

Parameters:
identifier - unique identifier of a launch group extension
Method Detail

run

public void run()
Description copied from class: Action
The default implementation of this IAction method does nothing. Subclasses should override this method if they do not need information from the triggering event, or override runWithEvent(Event) if they do.

Specified by:
run in interface IAction
Overrides:
run in class Action
See Also:
IAction.run()

dispose

public void dispose()
Description copied from interface: IWorkbenchWindowActionDelegate
Disposes this action delegate. The implementor should unhook any references to itself so that garbage collection can occur.

Specified by:
dispose in interface IWorkbenchWindowActionDelegate
See Also:
IWorkbenchWindowActionDelegate.dispose()

init

public void init(IWorkbenchWindow window)
Description copied from interface: IWorkbenchWindowActionDelegate
Initializes this action delegate with the workbench window it will work in.

Specified by:
init in interface IWorkbenchWindowActionDelegate
Parameters:
window - the window that provides the context for this delegate
See Also:
IWorkbenchWindowActionDelegate.init(org.eclipse.ui.IWorkbenchWindow)

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)

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)

Eclipse Platform
Release 3.1

Guidelines for using Eclipse APIs.

Copyright (c) IBM Corp. and others 2000, 2005. All rights reserved.