Package ghidra.app.services

Interface DebuggerListingService

All Superinterfaces:
CodeViewerService
public interface DebuggerListingService extends CodeViewerService
A service providing access to the main listing panel

  • 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

    • 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

    • 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