com.fr.design.gui.autocomplete

接口 Completion

所有超级接口:

java.lang.Comparable<Completion>

所有已知子接口:

ParameterizedCompletion

所有已知实现类:

AbstractCompletion, BasicCompletion, FunctionCompletion, MarkupTagCompletion, ShorthandCompletion, TemplateCompletion, VariableCompletion

public interface Completion
extends java.lang.Comparable<Completion>

Represents a completion choice. A CompletionProvider returns lists of objects implementing this interface. A Completion contains the following information:

• The text the user must (begin to) input for this to be a completion choice.
• The text that will be filled in if the user chooses this completion. Note that often, this is the same as the text the user must (begin to) enter, but this doesn't have to be the case.
• Summary HTML that describes this completion. This is information that can be displayed in a helper "tooltip"-style window beside the completion list. This may be null. It may also be lazily generated to cut down on memory usage.
• The CompletionProvider that returned this completion.
• Tool tip text that can be displayed when a mouse hovers over this completion in a text component.

版本:

1.0

作者:

Robert Futrell

另请参阅:

AbstractCompletion

方法概要

方法

限定符和类型	方法和说明
int	compareTo(Completion other) Compares this completion to another one lexicographically, ignoring case.
java.lang.String	getAlreadyEntered(javax.swing.text.JTextComponent comp) Returns the portion of this completion that has already been entered into the text component.
javax.swing.Icon	getIcon() Returns the icon to use for this completion.
java.lang.String	getInputText() Returns the text that the user has to (start) typing for this completion to be offered.
CompletionProvider	getProvider() Returns the provider that returned this completion.
int	getRelevance() Returns the "relevance" of this completion.
java.lang.String	getReplacementText() Returns the text to insert as the result of this auto-completion.
java.lang.String	getSummary() Returns the description of this auto-complete choice.
java.lang.String	getToolTipText() Returns the tool tip text to display for mouse hovers over this completion.

方法详细资料

compareTo

int compareTo(Completion other)

Compares this completion to another one lexicographically, ignoring case.

指定者:

compareTo 在接口中 java.lang.Comparable<Completion>

参数:

other - Another completion instance.

返回:

How this completion compares to the other one.

getAlreadyEntered

java.lang.String getAlreadyEntered(javax.swing.text.JTextComponent comp)

Returns the portion of this completion that has already been entered into the text component. The match is case-insensitive.

This is a convenience method for: getProvider().getAlreadyEnteredText(comp).

参数:

comp - The text component.

返回:

The already-entered portion of this completion.

getIcon

javax.swing.Icon getIcon()

Returns the icon to use for this completion.

返回:

The icon, or null for none.

getInputText

java.lang.String getInputText()

Returns the text that the user has to (start) typing for this completion to be offered. Note that this will usually be the same value as getReplacementText(), but not always (a completion could be a way to implement shorthand, for example, "sysout" mapping to "System.out.println(").

返回:

The text the user has to (start) typing for this completion to be offered.

另请参阅:

getReplacementText()

getProvider

CompletionProvider getProvider()

Returns the provider that returned this completion.

返回:

The provider.

getRelevance

int getRelevance()

Returns the "relevance" of this completion. This is used when sorting completions by their relevance. It is an abstract concept that may mean different things to different languages, and may depend on the context of the completion.

By default, all completions have a relevance of 0. The higher the value returned by this method, the higher up in the list this completion will be; the lower the value returned, the lower it will be. Completions with equal relevance values will be sorted alphabetically.

返回:

The relevance of this completion.

getReplacementText

java.lang.String getReplacementText()

Returns the text to insert as the result of this auto-completion. This is the "complete" text, including any text that replaces what the user has already typed.

返回:

The replacement text.

另请参阅:

getInputText()

getSummary

java.lang.String getSummary()

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

返回:

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

getToolTipText

java.lang.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).

返回:

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