Eclipse Plug-in Developer Guide (Galileo) - RunToLineHandler (Eclipse Platform API Specification)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

Eclipse Platform
Release 3.5

PREV CLASS NEXT CLASS

NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.eclipse.debug.ui.actions
Class RunToLineHandler


java.lang.Object
  
org.eclipse.debug.ui.actions.RunToLineHandler

All Implemented Interfaces:: IWorkspaceRunnable, IBreakpointManagerListener, IDebugEventSetListener

public class RunToLineHandler
extends Object
implements IDebugEventSetListener, IBreakpointManagerListener, IWorkspaceRunnable
extends Object
implements IDebugEventSetListener, IBreakpointManagerListener, IWorkspaceRunnable

Handles a run to line operation. Clients implementing a run to line action can use this handler to carry out a run to line operation implemented with a breakpoint. Handles the user preference to skip breakpoints while performing a run to line operation, and cancelling the run to line operation if another breakpoint is encountered before the operation is completed.

Clients may instantiate this class.

Since:: 3.1
Restriction:: This class is not intended to be subclassed by clients.

Constructor Summary

RunToLineHandler ( IDebugTarget target, ISuspendResume suspendResume, IBreakpoint breakpoint)
          Constructs a handler to perform a run to line operation.

Method Summary

void breakpointManagerEnablementChanged (boolean enabled)
          Notifies the listener that the breakpoint manager's enablement has changed.

void cancel ()
          Cancels the run to line operation.

void handleDebugEvents ( DebugEvent[] events)
          Notifies this listener of the given debug events.

void run ( IProgressMonitor monitor)
          Runs the operation reporting progress to and accepting cancellation requests from the given progress monitor.

Methods inherited from class java.lang. Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RunToLineHandler

public RunToLineHandler(
IDebugTarget target,
                        
ISuspendResume suspendResume,
                        
IBreakpoint breakpoint)

Constructs a handler to perform a run to line operation.

Parameters:: target - the debug target in which the operation is to be performed; suspendResume - the element to be resumed to begin the operation; breakpoint - the run to line breakpoint

Method Detail

handleDebugEvents

public void handleDebugEvents(
DebugEvent[] events)

Description copied from interface: IDebugEventSetListener

Notifies this listener of the given debug events. All of the events in the given event collection occurred at the same location the program be run or debugged.

Specified by:: handleDebugEvents in interface IDebugEventSetListener

Parameters:: events - the debug events

breakpointManagerEnablementChanged

public void breakpointManagerEnablementChanged(boolean enabled)

Description copied from interface: IBreakpointManagerListener

Notifies the listener that the breakpoint manager's enablement has changed.

Specified by:: breakpointManagerEnablementChanged in interface IBreakpointManagerListener

Parameters:: enabled - whether or not the breakpoint manager is enabled

cancel

public void cancel()

Cancels the run to line operation.

run

public void run(
IProgressMonitor monitor)
         throws 
CoreException

Description copied from interface: IWorkspaceRunnable

Runs the operation reporting progress to and accepting cancellation requests from the given progress monitor.

Implementors of this method should check the progress monitor for cancellation when it is safe and appropriate to do so. The cancellation request should be propagated to the caller by throwing OperationCanceledException.

Specified by:: run in interface IWorkspaceRunnable

Parameters:: monitor - a progress monitor, or null if progress reporting and cancellation are not desired
Throws:: CoreException - if this operation fails.