Eclipse GEF
2.1

org.eclipse.gef.ui.actions
Class SelectionAction

java.lang.Object
  |
  +--org.eclipse.jface.action.Action
        |
        +--org.eclipse.gef.ui.actions.WorkbenchPartAction
              |
              +--org.eclipse.gef.ui.actions.EditorPartAction
                    |
                    +--org.eclipse.gef.ui.actions.SelectionAction
All Implemented Interfaces:
Disposable, IAction, UpdateAction
Direct Known Subclasses:
AlignmentAction, DeleteAction, DirectEditAction

public abstract class SelectionAction
extends EditorPartAction

Superclass for an action needing the current selection.


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, IMAGE, TEXT, TOOL_TIP_TEXT
 
Constructor Summary
SelectionAction(IEditorPart editor)
          Deprecated. use IWorkbenchPart constructor, SelectionAction will be changed to inherit from WorkbenchPartAction in next release
SelectionAction(IWorkbenchPart part)
          Creates a SelectionAction and associates it with the given workbench part.
 
Method Summary
 void dispose()
          Performs and necessary cleanup.
protected  List getSelectedObjects()
          Returns a List containing the currently selected objects.
protected  ISelection getSelection()
          Gets the current selection.
protected  void handleSelectionChanged()
          Called when the selection is changed.
protected  void setSelection(ISelection selection)
          Sets the current selection and calls on subclasses to handle the selectionChanged event.
 void setSelectionProvider(ISelectionProvider provider)
          May be used to provide an alternative selection source other than the workbench's selection service.
 void update()
          Called to update the receiver.
 
Methods inherited from class org.eclipse.gef.ui.actions.EditorPartAction
getEditorPart, setEditorPart
 
Methods inherited from class org.eclipse.gef.ui.actions.WorkbenchPartAction
calculateEnabled, execute, getCommandStack, getWorkbenchPart, init, isEnabled, refresh, setLazyEnablementCalculation, setWorkbenchPart
 
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, removeAcceleratorText, removePropertyChangeListener, run, 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

SelectionAction

public SelectionAction(IEditorPart editor)
Deprecated. use IWorkbenchPart constructor, SelectionAction will be changed to inherit from WorkbenchPartAction in next release

Creates a SelectionAction and associates it with the given editor.

Parameters:
editor - The editor that this action is associated with.

SelectionAction

public SelectionAction(IWorkbenchPart part)
Creates a SelectionAction and associates it with the given workbench part.

Parameters:
part - the workbench part
Method Detail

dispose

public void dispose()
Description copied from interface: Disposable
Performs and necessary cleanup.

Specified by:
dispose in interface Disposable
Overrides:
dispose in class WorkbenchPartAction
See Also:
Disposable.dispose()

getSelectedObjects

protected List getSelectedObjects()
Returns a List containing the currently selected objects.

Returns:
A List containing the currently selected objects.

getSelection

protected ISelection getSelection()
Gets the current selection.

Returns:
The current selection.

handleSelectionChanged

protected void handleSelectionChanged()
Called when the selection is changed.


setSelection

protected void setSelection(ISelection selection)
Sets the current selection and calls on subclasses to handle the selectionChanged event.

Parameters:
selection - The new selection.

setSelectionProvider

public void setSelectionProvider(ISelectionProvider provider)
May be used to provide an alternative selection source other than the workbench's selection service. Use of this method is optional. The default value is null, in which case the selection is obtained using the partsite's selection service.

Parameters:
provider - null or a selection provider

update

public void update()
Description copied from interface: UpdateAction
Called to update the receiver.

Specified by:
update in interface UpdateAction
Overrides:
update in class WorkbenchPartAction
See Also:
WorkbenchPartAction.update()

Eclipse GEF
2.1

Copyright (c) IBM Corp. and others 2000, 2003. All Rights Reserved.