Module platform

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

Class FunctionCompletion

java.lang.Object

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

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

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

de.grogra.pf.ui.autocomplete.impl.FunctionCompletion

All Implemented Interfaces:

Completion, ParameterizedCompletion, Comparable<Completion>

public class FunctionCompletion
extends VariableCompletion
implements ParameterizedCompletion

A completion choice representing a function.

In order to use any instance of a ParameterizedCompletion, you need to call AutoCompletion#setParameterAssistanceEnabled(boolean) with a value of true first. Otherwise, any completion choices will be visible in the completion list, but won't insert anything when selected.

Version:

1.0

Author:

Robert Futrell

Nested Class Summary

Nested classes/interfaces inherited from interface de.grogra.pf.ui.autocomplete.impl.ParameterizedCompletion

ParameterizedCompletion.Parameter

Constructor Summary

Constructors

Constructor	Description
FunctionCompletion(CompletionProvider provider, String name, String returnType)	Constructor.

Method Summary

Modifier and Type	Method	Description
protected void	addDefinitionString(StringBuilder sb)
protected void	addParameters(StringBuilder sb)	Adds HTML describing the parameters to this function to a buffer.
boolean	equals(Object other)	Overridden to match the behavior of compareTo(Completion).
String	getCompareString()	Returns a string used to compare this method completion to another.
String	getDefinitionString()	Returns the "definition string" for this function completion.
ParameterizedCompletionInsertionInfo	getInsertionInfo(AutoCompletableTextArea tc, boolean replaceTabsWithSpaces)	Returns completion information for this parameterized completion, given the specified text component.
ParameterizedCompletion.Parameter	getParam(int index)	Returns the specified ParameterizedCompletion.Parameter.
int	getParamCount()	Returns the number of parameters to this function.
String	getReturnValueDescription()	Returns the description of the return value of this function.
boolean	getShowParameterToolTip()	Returns whether a tool tip displaying assistance for each parameter while it is being edited is appropriate for this completion.
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.
int	hashCode()
void	setParams(List<ParameterizedCompletion.Parameter> params)	Sets the parameters to this function.
void	setReturnValueDescription(String desc)	Sets the description of the return value of this function.

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

getDefinedIn, getName, getType, possiblyAddDefinedIn, possiblyAddDescription, setDefinedIn, toString

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, getIcon, getInputText, getProvider, getRelevance, setIcon, setRelevance

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface de.grogra.pf.ui.autocomplete.impl.Completion

compareTo, getAlreadyEntered, getIcon, getInputText, getProvider, getRelevance, getReplacementText

Constructor Details

FunctionCompletion

public FunctionCompletion(CompletionProvider provider,
 String name,
 String returnType)

Constructor.

Parameters:

provider - The parent provider.

name - The name of this function.

returnType - The return type of this function.

Method Details

addDefinitionString

protected void addDefinitionString(StringBuilder sb)

Overrides:

addDefinitionString in class VariableCompletion

addParameters

protected void addParameters(StringBuilder sb)

Adds HTML describing the parameters to this function to a buffer.

Parameters:

sb - The buffer to append to.

equals

public boolean equals(Object other)

Overridden to match the behavior of compareTo(Completion).

Overrides:

equals in class Object

Parameters:

other - Another object.

Returns:

Whether these two objects are equal.

getCompareString

public String getCompareString()

Returns a string used to compare this method completion to another.

Specified by:

getCompareString in interface Completion

Overrides:

getCompareString in class AbstractCompletion

Returns:

The comparison string.

getDefinitionString

public String getDefinitionString()

Returns the "definition string" for this function completion. For example, for the C "printf" function, this would return "int printf(const char *, ...)".

Specified by:

getDefinitionString in interface ParameterizedCompletion

Overrides:

getDefinitionString in class VariableCompletion

Returns:

The definition string.

getInsertionInfo

public ParameterizedCompletionInsertionInfo getInsertionInfo(AutoCompletableTextArea tc,
 boolean replaceTabsWithSpaces)

Description copied from interface: ParameterizedCompletion

Returns completion information for this parameterized completion, given the specified text component.

Specified by:

getInsertionInfo in interface ParameterizedCompletion

Parameters:

tc - The text component.

replaceTabsWithSpaces - Whether to replace tabs with spaces.

Returns:

The completion info.

getParam

public ParameterizedCompletion.Parameter getParam(int index)

Description copied from interface: ParameterizedCompletion

Returns the specified ParameterizedCompletion.Parameter.

Specified by:

getParam in interface ParameterizedCompletion

Parameters:

index - The index of the parameter to retrieve.

Returns:

The parameter.

See Also:

• ParameterizedCompletion.getParamCount()

getParamCount

public int getParamCount()

Returns the number of parameters to this function.

Specified by:

getParamCount in interface ParameterizedCompletion

Returns:

The number of parameters to this function.

See Also:

• getParam(int)

getShowParameterToolTip

public boolean getShowParameterToolTip()

Description copied from interface: ParameterizedCompletion

Returns whether a tool tip displaying assistance for each parameter while it is being edited is appropriate for this completion.

Specified by:

getShowParameterToolTip in interface ParameterizedCompletion

Returns:

Whether the tool tip is appropriate to display.

getReturnValueDescription

public String getReturnValueDescription()

Returns the description of the return value of this function.

Returns:

The description, or null if there is none.

See Also:

• setReturnValueDescription(String)

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 VariableCompletion

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()

Description copied from class: VariableCompletion

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 VariableCompletion

Returns:

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

hashCode

public int hashCode()

Overrides:

hashCode in class Object

setParams

public void setParams(List<ParameterizedCompletion.Parameter> params)

Sets the parameters to this function.

Parameters:

params - The parameters. This should be a list of ParameterizedCompletion.Parameters.

See Also:

• getParam(int)
• getParamCount()

setReturnValueDescription

public void setReturnValueDescription(String desc)

Sets the description of the return value of this function.

Parameters:

desc - The description.

See Also:

• getReturnValueDescription()