Package ghidra.app.util.viewer.field

Class XRefFieldFactory

java.lang.Object

ghidra.app.util.viewer.field.FieldFactory

ghidra.app.util.viewer.field.XRefFieldFactory

All Implemented Interfaces:

ExtensionPoint

Direct Known Subclasses:

VariableXRefFieldFactory, XRefHeaderFieldFactory

public class XRefFieldFactory
extends FieldFactory

Cross-reference Field Factory

Nested Class Summary

Nested Classes

Change	Modifier and Type	Class	Description
	static class	XRefFieldFactory.SORT_CHOICE

Nested classes/interfaces inherited from interface ghidra.util.classfinder.ExtensionPoint

ExtensionPoint.Exclude, ExtensionPoint.Util

Field Summary

Fields

Change	Modifier and Type	Field	Description
NEW	protected java.lang.String	delim
NEW	protected boolean	displayBlockName
NEW	protected boolean	displayLocalNamespace
NEW	protected boolean	displayNonLocalNamespace
NEW	protected boolean	displayRefType
	static java.lang.String	FIELD_NAME
NEW	protected java.lang.String	localPrefixText
NEW	protected int	maxXRefs
NEW	protected java.awt.Color	offcutColor
NEW	protected java.awt.Color	otherColor
NEW	protected java.awt.Color	readColor
NEW	protected XRefFieldFactory.SORT_CHOICE	sortChoice
NEW	protected java.util.Comparator<Reference>	typeComparator
NEW	protected boolean	useLocalPrefixOverride
NEW	protected java.awt.Color	writeColor

Fields inherited from class ghidra.app.util.viewer.field.FieldFactory

baseFont, color, colorOptionName, DEFAULT_FIELD_FONT, displayOptions, enabled, FONT_OPTION_NAME, hlProvider, model, name, startX, style, styleOptionName, underlineColor, width

Constructor Summary

Constructors

Change	Modifier	Constructor	Description
		XRefFieldFactory()	Constructor
		XRefFieldFactory(FieldFormatModel model, HighlightProvider hlProvider, Options displayOptions, ToolOptions fieldOptions)	Constructor
	protected	XRefFieldFactory(java.lang.String name)
	protected	XRefFieldFactory(java.lang.String name, FieldFormatModel model, HighlightProvider hlProvider, Options displayOptions, ToolOptions fieldOptions)	Constructs a new XRefFieldFactory based on the provider and model.

Method Summary

Change	Modifier and Type	Method	Description
	boolean	acceptsType(int category, java.lang.Class<?> proxyObjectClass)	Used to specify which format models this field can belong to.
NEW	protected FieldLocation	createFieldLocation(int xrefPos, int xrefIndex, ListingTextField field, java.math.BigInteger index, int fieldNum)
NEW	protected AttributedString	createRefTypeAttributedString(Reference reference, AttributedString referenceString)
	void	displayOptionsChanged(Options options, java.lang.String optionName, java.lang.Object oldValue, java.lang.Object newValue)	Notifications that the display options changed.
	void	fieldOptionsChanged(Options options, java.lang.String optionName, java.lang.Object oldValue, java.lang.Object newValue)	Notifications that the field options changed.
NEW	protected java.lang.String	getBlockName(Program pgm, Address addr)
	java.awt.Color	getDefaultColor()	Returns the default field color.
	ListingField	getField(ProxyObj<?> proxy, int varWidth)	Generates a Field based on the given information.
	FieldLocation	getFieldLocation(ListingField bf, java.math.BigInteger index, int fieldNum, ProgramLocation loc)	Return a FieldLocation that corresponds to the given index, fieldNum, and ProgramLocation IF and ONLY IF the given programLocation is the type generated by this class's FieldFactory.getFieldLocation(ListingField, BigInteger, int, ProgramLocation).
NEW	protected java.lang.String	getPrefix(Program program, Reference reference, Function currentFunction)
NEW	protected Program	getProgram(java.lang.Object obj)
	ProgramLocation	getProgramLocation(int row, int col, ListingField bf)	Returns the Program location for the given object, row, col, and groupPath
NEW	protected Address	getXRefLocation(java.lang.Object obj)	Get an address location for this object.
	FieldFactory	newInstance(FieldFormatModel formatModel, HighlightProvider provider, ToolOptions displayOptions, ToolOptions fieldOptions)	Returns a new instance of this FieldFactory that can be used to generate fields instead of being used as a prototype.

Methods inherited from class ghidra.app.util.viewer.field.FieldFactory

getFieldModel, getFieldName, getFieldText, getMetrics, getMetrics, getStartX, getWidth, hasSamePath, initDisplayOptions, isEnabled, optionsChanged, servicesChanged, setEnabled, setStartX, setWidth

Methods inherited from class java.lang.Object

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

Field Detail

FIELD_NAME

public static final java.lang.String FIELD_NAME

See Also:

Constant Field Values

sortChoice NEW

protected XRefFieldFactory.SORT_CHOICE sortChoice

offcutColor NEW

protected java.awt.Color offcutColor

readColor NEW

protected java.awt.Color readColor

writeColor NEW

protected java.awt.Color writeColor

otherColor NEW

protected java.awt.Color otherColor

delim NEW

protected java.lang.String delim

displayBlockName NEW

protected boolean displayBlockName

maxXRefs NEW

protected int maxXRefs

displayRefType NEW

protected boolean displayRefType

typeComparator NEW

protected java.util.Comparator<Reference> typeComparator

displayLocalNamespace NEW

protected boolean displayLocalNamespace

displayNonLocalNamespace NEW

protected boolean displayNonLocalNamespace

useLocalPrefixOverride NEW

protected boolean useLocalPrefixOverride

localPrefixText NEW

protected java.lang.String localPrefixText

Constructor Detail

XRefFieldFactory

public XRefFieldFactory()

Constructor

XRefFieldFactory

protected XRefFieldFactory(java.lang.String name)

XRefFieldFactory

public XRefFieldFactory(FieldFormatModel model,
                        HighlightProvider hlProvider,
                        Options displayOptions,
                        ToolOptions fieldOptions)

Constructor

Parameters:

model - the model that the field belongs to.

hlProvider - the HightLightProvider.

displayOptions - the Options for display properties.

fieldOptions - the Options for field specific properties.

XRefFieldFactory

protected XRefFieldFactory(java.lang.String name,
                           FieldFormatModel model,
                           HighlightProvider hlProvider,
                           Options displayOptions,
                           ToolOptions fieldOptions)

Constructs a new XRefFieldFactory based on the provider and model.

Parameters:

name - the owner of this field factory

model - the model that the field belongs to.

hlProvider - the HightLightProvider.

displayOptions - the Options for display properties.

fieldOptions - the Options for field specific properties.

Method Detail

displayOptionsChanged

public void displayOptionsChanged(Options options,
                                  java.lang.String optionName,
                                  java.lang.Object oldValue,
                                  java.lang.Object newValue)

Description copied from class: FieldFactory

Notifications that the display options changed.

Overrides:

displayOptionsChanged in class FieldFactory

Parameters:

options - the Display Options object that changed.

optionName - the name of the property that changed.

oldValue - the old value of the property.

newValue - the new value of the property.

fieldOptionsChanged

public void fieldOptionsChanged(Options options,
                                java.lang.String optionName,
                                java.lang.Object oldValue,
                                java.lang.Object newValue)

Description copied from class: FieldFactory

Notifications that the field options changed.

Overrides:

fieldOptionsChanged in class FieldFactory

Parameters:

options - the Field Options object that changed.

optionName - the name of the property that changed.

oldValue - the old value of the property.

newValue - the new value of the property.

getDefaultColor

public java.awt.Color getDefaultColor()

Description copied from class: FieldFactory

Returns the default field color.

Overrides:

getDefaultColor in class FieldFactory

getField

public ListingField getField(ProxyObj<?> proxy,
                             int varWidth)

Description copied from class: FieldFactory

Generates a Field based on the given information.

Specified by:

getField in class FieldFactory

Parameters:

proxy - The object that the generated field will report some information about.

varWidth - the additional distance along the x axis to place the generated field.

Returns:

the newly generated FactoryField that shows some property or information about the given object.

createRefTypeAttributedString NEW

protected AttributedString createRefTypeAttributedString(Reference reference,
                                                         AttributedString referenceString)

getPrefix NEW

protected java.lang.String getPrefix(Program program,
                                     Reference reference,
                                     Function currentFunction)

getFieldLocation

public FieldLocation getFieldLocation(ListingField bf,
                                      java.math.BigInteger index,
                                      int fieldNum,
                                      ProgramLocation loc)

Description copied from class: FieldFactory

Return a FieldLocation that corresponds to the given index, fieldNum, and ProgramLocation IF and ONLY IF the given programLocation is the type generated by this class's FieldFactory.getFieldLocation(ListingField, BigInteger, int, ProgramLocation). Each FieldFactory should generate and process a unique ProgramLocation class.

Specified by:

getFieldLocation in class FieldFactory

Parameters:

bf - the ListingField at the current cursor.

index - the line index (corresponds to an address)

fieldNum - the index of field within the layout to try and get a FieldLocation.

loc - the ProgramLocation to be converted into a FieldLocation.

createFieldLocation NEW

protected FieldLocation createFieldLocation(int xrefPos,
                                            int xrefIndex,
                                            ListingTextField field,
                                            java.math.BigInteger index,
                                            int fieldNum)

getProgramLocation

public ProgramLocation getProgramLocation(int row,
                                          int col,
                                          ListingField bf)

Description copied from class: FieldFactory

Returns the Program location for the given object, row, col, and groupPath

Specified by:

getProgramLocation in class FieldFactory

Parameters:

row - the row within this field

col - the col on the given row within this field.

bf - the ListingField containing the cursor.

getBlockName NEW

protected java.lang.String getBlockName(Program pgm,
                                        Address addr)

getXRefLocation NEW

protected Address getXRefLocation(java.lang.Object obj)

Get an address location for this object.

Parameters:

obj - object to get location from

getProgram NEW

protected Program getProgram(java.lang.Object obj)

acceptsType

public boolean acceptsType(int category,
                           java.lang.Class<?> proxyObjectClass)

Description copied from class: FieldFactory

Used to specify which format models this field can belong to.

Specified by:

acceptsType in class FieldFactory

Parameters:

category - the category for this field

proxyObjectClass - the type of proxy object used by this field

Returns:

true if this class accepts the given category.

newInstance

public FieldFactory newInstance(FieldFormatModel formatModel,
                                HighlightProvider provider,
                                ToolOptions displayOptions,
                                ToolOptions fieldOptions)

Description copied from class: FieldFactory

Returns a new instance of this FieldFactory that can be used to generate fields instead of being used as a prototype.

Specified by:

newInstance in class FieldFactory

Parameters:

formatModel - the model that the field belongs to.

provider - the HightLightProvider.

displayOptions - the Options for display properties.

fieldOptions - the Options for field specific properties.