Eclipse Platform
2.0

org.eclipse.ui.texteditor
Class SelectMarkerRulerAction

java.lang.Object
  |
  +--org.eclipse.jface.action.Action
        |
        +--org.eclipse.ui.texteditor.ResourceAction
              |
              +--org.eclipse.ui.texteditor.SelectMarkerRulerAction
All Implemented Interfaces:
IAction, IUpdate
Direct Known Subclasses:
SelectMarkerRulerInfoAction

public class SelectMarkerRulerAction
extends ResourceAction
implements IUpdate

A ruler action which can select the textual range of a marker that has a visual representation in the vertical ruler.

This class may be instantiated but is not intended for subclassing.

Since:
2.0

Field Summary
 
Fields inherited from interface org.eclipse.jface.action.IAction
AS_CHECK_BOX, AS_DROP_DOWN_MENU, AS_PUSH_BUTTON, CHECKED, DESCRIPTION, ENABLED, IMAGE, TEXT, TOOL_TIP_TEXT
 
Constructor Summary
SelectMarkerRulerAction(ResourceBundle bundle, String prefix, ITextEditor editor, IVerticalRulerInfo ruler)
          Creates a new action for the given ruler and editor.
SelectMarkerRulerAction(ResourceBundle bundle, String prefix, IVerticalRuler ruler, ITextEditor editor)
          Deprecated. use SelectMarkerRulerInfoAction(ResourceBundle, String, IVerticalRulerInfo, ITextEditor)
 
Method Summary
protected  IMarker chooseMarker(List markers)
          Chooses the marker with the highest layer.
protected  AbstractMarkerAnnotationModel getAnnotationModel()
          Returns the AbstractMarkerAnnotationModel of the editor's input.
protected  IDocument getDocument()
          Returns the IDocument of the editor's input.
protected  List getMarkers()
          Returns all markers which include the ruler's line of activity.
protected  IResource getResource()
          Returns the resource for which to create the marker, or null if there is no applicable resource.
protected  void handleCoreException(CoreException exception, String message)
          Handles core exceptions.
protected  boolean includesRulerLine(Position position, IDocument document)
          Checks whether a position includes the ruler's line of activity.
 void run()
          The default implementation of this IAction method does nothing.
 void update()
          Requests that this object update itself.
 
Methods inherited from class org.eclipse.ui.texteditor.ResourceAction
getString, setHelpContextId
 
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, removeAcceleratorText, 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

SelectMarkerRulerAction

public SelectMarkerRulerAction(ResourceBundle bundle,
                               String prefix,
                               ITextEditor editor,
                               IVerticalRulerInfo ruler)
Creates a new action for the given ruler and editor. The action configures its visual representation from the given resource bundle.

Parameters:
bundle - the resource bundle
prefix - a prefix to be prepended to the various resource keys (described in ResourceAction constructor), or null if none
editor - the editor
ruler - the ruler
See Also:
ResourceAction.ResourceAction(java.util.ResourceBundle, java.lang.String)

SelectMarkerRulerAction

public SelectMarkerRulerAction(ResourceBundle bundle,
                               String prefix,
                               IVerticalRuler ruler,
                               ITextEditor editor)
Deprecated. use SelectMarkerRulerInfoAction(ResourceBundle, String, IVerticalRulerInfo, ITextEditor)

Method Detail

update

public void update()
Description copied from interface: IUpdate
Requests that this object update itself.

Specified by:
update in interface IUpdate

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 run(Event) if they do.

Specified by:
run in interface IAction
Overrides:
run in class Action

chooseMarker

protected IMarker chooseMarker(List markers)
Chooses the marker with the highest layer. If there are multiple markers at the found layer, the first marker is taken.

Parameters:
markers - the list of markers to choose from
Returns:
the chosen marker

getResource

protected IResource getResource()
Returns the resource for which to create the marker, or null if there is no applicable resource.

Returns:
the resource for which to create the marker or null

getAnnotationModel

protected AbstractMarkerAnnotationModel getAnnotationModel()
Returns the AbstractMarkerAnnotationModel of the editor's input.

Returns:
the marker annotation model

getDocument

protected IDocument getDocument()
Returns the IDocument of the editor's input.

Returns:
the document of the editor's input

includesRulerLine

protected boolean includesRulerLine(Position position,
                                    IDocument document)
Checks whether a position includes the ruler's line of activity.

Parameters:
position - the position to be checked
document - the document the position refers to
Returns:
true if the line is included by the given position

handleCoreException

protected void handleCoreException(CoreException exception,
                                   String message)
Handles core exceptions. This implementation logs the exceptions with the workbech plugin and shows an error dialog.

Parameters:
exception - the exception to be handled
message - the message to be logged with the given exception

getMarkers

protected List getMarkers()
Returns all markers which include the ruler's line of activity.

Returns:
all markers which include the ruler's line of activity

Eclipse Platform
2.0

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