Module platform

Package de.grogra.pf.ui.autocomplete.impl

Class VariableCompletion

java.lang.Object

de.grogra.pf.ui.autocomplete.impl.AbstractCompletion

de.grogra.pf.ui.autocomplete.impl.BasicCompletion

de.grogra.pf.ui.autocomplete.impl.VariableCompletion

All Implemented Interfaces:

Completion, Comparable<Completion>

Direct Known Subclasses:

FunctionCompletion

public class VariableCompletion
extends BasicCompletion

A completion for a variable (or constant) in a programming language.

This completion type uses its shortDescription property as part of its summary returned by getSummary(); for this reason, it may be a little longer (even much longer), if desired, than what is recommended for BasicCompletions (where the shortDescription is used in toString() for ListCellRenderers).

Version:

1.0

Author:

Robert Futrell

Constructor Summary

Constructors

Constructor	Description
VariableCompletion(CompletionProvider provider, String name, String type)	Constructor.

Method Summary

Modifier and Type	Method	Description
protected void	addDefinitionString(StringBuilder sb)
String	getDefinedIn()	Returns where this variable is defined.
String	getDefinitionString()	Return the definition of this variable completion.
String	getName()	Returns the name of this variable.
String	getSummary()	Returns the description of this auto-complete choice.
String	getToolTipText()	Returns the tool tip text to display for mouse hovers over this completion.
String	getType()	Returns the type of this variable.
protected void	possiblyAddDefinedIn(StringBuilder sb)	Adds some HTML describing where this variable is defined, if this information is known.
protected boolean	possiblyAddDescription(StringBuilder sb)	Adds the description text as HTML to a buffer, if a description is defined.
void	setDefinedIn(String definedIn)	Sets where this variable is defined.
String	toString()	Overridden to return the name of the variable being completed.

Methods inherited from class de.grogra.pf.ui.autocomplete.impl.BasicCompletion

getReplacementText, getShortDescription, setShortDescription, setSummary

Methods inherited from class de.grogra.pf.ui.autocomplete.impl.AbstractCompletion

compareTo, getAlreadyEntered, getCompareString, getIcon, getInputText, getProvider, getRelevance, setIcon, setRelevance

Methods inherited from class java.lang.Object

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

Constructor Details

VariableCompletion

public VariableCompletion(CompletionProvider provider,
 String name,
 String type)

Constructor.

Parameters:

provider - The parent provider.

name - The name of this variable.

type - The type of this variable (e.g. "int", "String", etc.).

Method Details

addDefinitionString

protected void addDefinitionString(StringBuilder sb)

getDefinitionString

public String getDefinitionString()

Return the definition of this variable completion.

Returns:

The definition string.

getDefinedIn

public String getDefinedIn()

Returns where this variable is defined.

Returns:

Where this variable is defined.

See Also:

• setDefinedIn(String)

getName

public String getName()

Returns the name of this variable.

Returns:

The name.

getSummary

public String getSummary()

Description copied from interface: Completion

Returns the description of this auto-complete choice. This can be used in a popup "description window."

Specified by:

getSummary in interface Completion

Overrides:

getSummary in class BasicCompletion

Returns:

This item's description. This should be HTML. It may be null if there is no description for this completion.

getToolTipText

public String getToolTipText()

Returns the tool tip text to display for mouse hovers over this completion.

Note that for this functionality to be enabled, a JTextComponent must be registered with the ToolTipManager, and the text component must know to search for this value. In the case of an RSyntaxTextArea, this can be done with a org.fife.ui.rtextarea.ToolTipSupplier that calls into CompletionProvider.getCompletionsAt(JTextComponent, java.awt.Point).

Specified by:

getToolTipText in interface Completion

Overrides:

getToolTipText in class AbstractCompletion

Returns:

The tool tip text for this completion, or null if none.

getType

public String getType()

Returns the type of this variable.

Returns:

The type.

possiblyAddDefinedIn

protected void possiblyAddDefinedIn(StringBuilder sb)

Adds some HTML describing where this variable is defined, if this information is known.

Parameters:

sb - The buffer to append to.

possiblyAddDescription

protected boolean possiblyAddDescription(StringBuilder sb)

Adds the description text as HTML to a buffer, if a description is defined.

Parameters:

sb - The buffer to append to.

Returns:

Whether there was a description to add.

setDefinedIn

public void setDefinedIn(String definedIn)

Sets where this variable is defined.

Parameters:

definedIn - Where this variable is defined.

See Also:

• getDefinedIn()

toString

public String toString()

Overridden to return the name of the variable being completed.

Overrides:

toString in class BasicCompletion

Returns:

A string representation of this completion.