Interface DebuggerListingService

All Superinterfaces:

CodeViewerService

public interface DebuggerListingService
extends CodeViewerService

A service providing access to the main listing panel

Nested Class Summary

Nested Classes

Change	Modifier and Type	Interface	Description
	static interface	DebuggerListingService.LocationTrackingSpecChangeListener	A listener for changes in location tracking specification

Method Summary

Change	Modifier and Type	Method	Description
	void	addTrackingSpecChangeListener(DebuggerListingService.LocationTrackingSpecChangeListener listener)	Add a listener for changes to the tracking specification.
	MultiBlendedListingBackgroundColorModel	createListingBackgroundColorModel(ListingPanel listingPanel)	Obtain a coloring background model suitable for the given listing
	DebuggerListing	createNewListing()	Create a new disconnected debugger listing
	String	findNextCustomTitle()	Get the next custom title for a DebuggerListing
	List<DebuggerListing>	getAllListings()	Get all debugger listings
	AutoReadMemorySpec	getAutoReadMemorySpec()	Get the auto-read memory specification of the main listing.
	SleighUtils.LitIdMode	getGoToSleighMode()	Get the mode of the Go-to dialog's Sleigh expressions
	LocationTrackingSpec	getTrackingSpec()	Get the tracking specification of the main listing.
	boolean	goTo(Address address, boolean centerOnScreen)	Navigate to the given address
	void	removeTrackingSpecChangeListener(DebuggerListingService.LocationTrackingSpecChangeListener listener)	Remove a listener for changes to the tracking specification.
	void	setCurrentSelection(ProgramSelection selection)	Set the selection of addresses in this listing.
	void	setGoToSleighMode(SleighUtils.LitIdMode mode)	Set the mode of the Go-to dialog's Sleigh expressions
	void	setTrackingSpec(LocationTrackingSpec spec)	Set the tracking specification of the listing.

Methods inherited from interface CodeViewerService

addButtonPressedListener, addListingDisplayListener, addLocalAction, addMarginProvider, addOverviewProvider, addProgramDropProvider, getAddressIndexMap, getCurrentField, getCurrentFieldTextSelection, getCurrentLocation, getCurrentSelection, getFieldPanel, getFormatManager, getListingModel, getListingPanel, getNavigatable, getView, goTo, removeButtonPressedListener, removeHighlightProvider, removeListingDisplayListener, removeListingPanel, removeLocalAction, removeMarginProvider, removeOverviewProvider, requestFocus, setCoordinatedListingPanelListener, setHighlightProvider, setListingPanel, setNorthComponent, updateDisplay

Method Details

setTrackingSpec

void setTrackingSpec(LocationTrackingSpec spec)

Set the tracking specification of the listing. Navigates immediately.

Parameters:

spec - the desired specification

getTrackingSpec

LocationTrackingSpec getTrackingSpec()

Get the tracking specification of the main listing.

Returns:

the current specification

createNewListing NEW

DebuggerListing createNewListing()

Create a new disconnected debugger listing

Returns:

newly created debugger listing

getAllListings NEW

List<DebuggerListing> getAllListings()

Get all debugger listings

Returns:

List of all debugger listings

getAutoReadMemorySpec

AutoReadMemorySpec getAutoReadMemorySpec()

Get the auto-read memory specification of the main listing.

Returns:

the current specification

addTrackingSpecChangeListener

void addTrackingSpecChangeListener(DebuggerListingService.LocationTrackingSpecChangeListener listener)

Add a listener for changes to the tracking specification.

Parameters:

listener - the listener to receive change notifications

removeTrackingSpecChangeListener

void removeTrackingSpecChangeListener(DebuggerListingService.LocationTrackingSpecChangeListener listener)

Remove a listener for changes to the tracking specification.

Parameters:

listener - the listener receiving change notifications

setCurrentSelection

void setCurrentSelection(ProgramSelection selection)

Set the selection of addresses in this listing.

Parameters:

selection - the desired selection

goTo

boolean goTo(Address address,
 boolean centerOnScreen)

Navigate to the given address

Parameters:

address - the desired address

centerOnScreen - true to center the cursor in the listing

Returns:

true if the request was effective

setGoToSleighMode NEW

void setGoToSleighMode(SleighUtils.LitIdMode mode)

Set the mode of the Go-to dialog's Sleigh expressions

This applies to all Go-to dialogs among the dynamic providers, including listings and memory (hex byte) views.

Parameters:

mode - the new mode

getGoToSleighMode NEW

SleighUtils.LitIdMode getGoToSleighMode()

Get the mode of the Go-to dialog's Sleigh expressions

Returns:

the current mode

createListingBackgroundColorModel

MultiBlendedListingBackgroundColorModel createListingBackgroundColorModel(ListingPanel listingPanel)

Obtain a coloring background model suitable for the given listing

This may be used, e.g., to style an alternative view in the same manner as listings managed by this service. Namely, this provides coloring for memory state and the user's cursor. Coloring for tracked locations and the marker service in general must still be added separately, since they incorporate additional dependencies.

Parameters:

listingPanel - the panel to be colored

Returns:

a blended background color model implementing the common debugger listing style

findNextCustomTitle NEW

String findNextCustomTitle()

Get the next custom title for a DebuggerListing

Returns:

Next custom title