Package ghidra.graph

Class VisualGraphComponentProvider<V extends VisualVertex,E extends VisualEdge<V>,G extends VisualGraph<V,E>>

java.lang.Object

docking.ComponentProvider

ghidra.graph.VisualGraphComponentProvider<V,E,G>

Type Parameters:

V - the vertex type

E - the edge type

G - the graph type

All Implemented Interfaces:

ActionContextProvider, HelpDescriptor

public abstract class VisualGraphComponentProvider<V extends VisualVertex,E extends VisualEdge<V>,G extends VisualGraph<V,E>>
extends ComponentProvider

A base component provider for displaying VisualGraphs

This class will provide many optional sub-features, enabled as desired by calling the various addXyzFeature() methods.

Implementation Notes: to get full functionality, you must:

• Have your plugin call readConfigState(SaveState) and writeConfigState(SaveState) to save user settings.
• Enable features you desire after calling your ComponentProvider.addToTool() method.

Field Summary

Fields inherited from class docking.ComponentProvider

DEFAULT_WINDOW_GROUP, dockingTool

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	VisualGraphComponentProvider(Tool tool, String name, String owner)
protected	VisualGraphComponentProvider(Tool tool, String name, String owner, Class<?> contextType)

Method Summary

Modifier and Type	Method	Description
protected void	addSatelliteFeature()	Adds the satellite viewer functionality to this provider
void	componentHidden()	Notifies the provider that the component is being hidden.
void	componentShown()	Notifies the provider that the component is being shown.
void	dispose()	To be called at the end of this provider's lifecycle
ActionContext	getActionContext(MouseEvent event)	Returns the context object which corresponds to the area of focus within this provider's component.
protected ComponentProvider	getSatelliteProvider()
Set<V>	getSelectedVertices()
abstract VisualGraphView<V,E,G>	getView()	You must return your graph view from this method
boolean	isSatelliteDocked()	Returns true if the satellite is embedded in the graph view, whether it is showing or not
boolean	isSatelliteShowing()	Returns true if the satellite is showing, whether in the graph or undocked
void	readConfigState(SaveState saveState)	Reads previously saved state from the given state object
void	writeConfigState(SaveState saveState)	Writes this providers saveable state to the given state object

Methods inherited from class docking.ComponentProvider

addLocalAction, addToTool, addToToolbar, adjustFontSize, canBeParent, closeComponent, componentActivated, componentDeactived, componentMadeDisplayable, contextChanged, createContext, createContext, createContext, getBaseIcon, getComponent, getContextType, getDefaultWindowPosition, getHelpInfo, getHelpLocation, getHelpObject, getIcon, getInstanceID, getIntraGroupPosition, getLocalActions, getMappedName, getMappedOwner, getName, getOwner, getSubTitle, getTabText, getTitle, getTool, getWindowGroup, getWindowSubMenuName, initializeInstanceID, isActive, isFocusedProvider, isInTool, isShowing, isSnapshot, isTransient, isVisible, registerAdjustableFontId, registerProviderNameOwnerChange, removeAllLocalActions, removeFromTool, removeLocalAction, requestFocus, resetFontSize, setCustomSubTitle, setCustomTabText, setCustomTitle, setDefaultFocusComponent, setDefaultWindowPosition, setHelpLocation, setIcon, setIntraGroupPosition, setKeyBinding, setSubTitle, setTabText, setTitle, setTransient, setVisible, setWindowGroup, setWindowMenuGroup, toFront, toString

Methods inherited from class java.lang.Object

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

Constructor Details

VisualGraphComponentProvider

protected VisualGraphComponentProvider(Tool tool,
 String name,
 String owner)

VisualGraphComponentProvider

protected VisualGraphComponentProvider(Tool tool,
 String name,
 String owner,
 Class<?> contextType)

Method Details

getView

public abstract VisualGraphView<V,E,G> getView()

You must return your graph view from this method

Returns:

your graph view

componentHidden

public void componentHidden()

Description copied from class: ComponentProvider

Notifies the provider that the component is being hidden. This happens when the provider is being closed.

Overrides:

componentHidden in class ComponentProvider

componentShown

public void componentShown()

Description copied from class: ComponentProvider

Notifies the provider that the component is being shown. This method will be called as the component hierarchy is being created, which means that this provider may not actually be visible to the user at the time of this call.

Overrides:

componentShown in class ComponentProvider

See Also:

• ComponentProvider.componentMadeDisplayable()

isSatelliteShowing

public boolean isSatelliteShowing()

Returns true if the satellite is showing, whether in the graph or undocked

Returns:

true if the satellite is showing, whether in the graph or undocked

isSatelliteDocked

public boolean isSatelliteDocked()

Returns true if the satellite is embedded in the graph view, whether it is showing or not

Returns:

true if the satellite is embedded in the graph view, whether it is showing or not

getSelectedVertices

public Set<V> getSelectedVertices()

getSatelliteProvider

protected ComponentProvider getSatelliteProvider()

addSatelliteFeature

protected void addSatelliteFeature()

Adds the satellite viewer functionality to this provider

dispose

public void dispose()

To be called at the end of this provider's lifecycle

writeConfigState

public void writeConfigState(SaveState saveState)

Writes this providers saveable state to the given state object

Parameters:

saveState - the state object into which state is to be written

readConfigState

public void readConfigState(SaveState saveState)

Reads previously saved state from the given state object

Parameters:

saveState - the state object that may contain state information for this provider

getActionContext

public ActionContext getActionContext(MouseEvent event)

Description copied from class: ComponentProvider

Returns the context object which corresponds to the area of focus within this provider's component. Null is returned when there is no context.

Specified by:

getActionContext in interface ActionContextProvider

Overrides:

getActionContext in class ComponentProvider

Parameters:

event - popup event which corresponds to this request. May be null for key-stroke or other non-mouse event.