org.das2.jythoncompletion

Class MessageCompletionItem

java.lang.Object

org.das2.jythoncompletion.MessageCompletionItem

All Implemented Interfaces:

CompletionItem

public class MessageCompletionItem
extends java.lang.Object
implements CompletionItem

Completion that just shows a message.

Constructor Summary

Constructors

Constructor and Description
MessageCompletionItem(java.lang.String message)
MessageCompletionItem(java.lang.String message, java.lang.String documentation)

Method Summary

Modifier and Type	Method and Description
CompletionTask	createDocumentationTask() Returns a task used to obtain a documentation associated with the item if there is any.
CompletionTask	createToolTipTask() Returns a task used to obtain a tooltip hint associated with the item if there is any.
void	defaultAction(javax.swing.text.JTextComponent component) Gets invoked when user presses VK_ENTER key or when she double-clicks on this item with the mouse cursor.
java.lang.CharSequence	getInsertPrefix() Returns a text used for finding of a longest common prefix after the TAB gets pressed or when the completion is opened explicitly.
int	getPreferredWidth(java.awt.Graphics g, java.awt.Font defaultFont) Get the preferred visual width of this item.
int	getSortPriority() Returns the item's priority.
java.lang.CharSequence	getSortText() Returns a text used to sort items alphabetically.
boolean	instantSubstitution(javax.swing.text.JTextComponent component) When enabled for the item the instant substitution should process the item in the same way like when the item is displayed and Enter key gets pressed by the user.
void	processKeyEvent(java.awt.event.KeyEvent evt) Process the key pressed when this completion item was selected in the completion popup window.
void	render(java.awt.Graphics graphics, java.awt.Font defaultFont, java.awt.Color defaultColor, java.awt.Color backgroundColor, int width, int height, boolean selected) Render this item into the given graphics.

Methods inherited from class java.lang.Object

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

Constructor Detail

MessageCompletionItem

public MessageCompletionItem(java.lang.String message)

MessageCompletionItem

public MessageCompletionItem(java.lang.String message,
                             java.lang.String documentation)

Method Detail

defaultAction

public void defaultAction(javax.swing.text.JTextComponent component)

Description copied from interface: CompletionItem

Gets invoked when user presses VK_ENTER key or when she double-clicks on this item with the mouse cursor.
This method gets invoked from AWT thread.

Specified by:

defaultAction in interface CompletionItem

Parameters:

component - non-null text component for which the completion was invoked.

processKeyEvent

public void processKeyEvent(java.awt.event.KeyEvent evt)

Description copied from interface: CompletionItem

Process the key pressed when this completion item was selected in the completion popup window.
This method gets invoked from AWT thread.

Specified by:

processKeyEvent in interface CompletionItem

Parameters:

evt - non-null key event of the pressed key. It should be consumed in case the item is sensitive to the given key. The source of this event is the text component to which the corresponding action should be performed.

getPreferredWidth

public int getPreferredWidth(java.awt.Graphics g,
                             java.awt.Font defaultFont)

Description copied from interface: CompletionItem

Get the preferred visual width of this item.
The visual height of the item is fixed to 16 points.

Specified by:

getPreferredWidth in interface CompletionItem

Parameters:

g - graphics that can be used for determining the preferred width e.g. getting of the font metrics.

defaultFont - default font used for rendering.

render

public void render(java.awt.Graphics graphics,
                   java.awt.Font defaultFont,
                   java.awt.Color defaultColor,
                   java.awt.Color backgroundColor,
                   int width,
                   int height,
                   boolean selected)

Description copied from interface: CompletionItem

Render this item into the given graphics.

Specified by:

render in interface CompletionItem

Parameters:

graphics - graphics to render the item into.

defaultFont - default font used for rendering.

defaultColor - default color used for rendering.

backgroundColor - color used for background.

width - width of the area to render into.

height - height of the are to render into.

selected - whether this item is visually selected in the list into which the items are being rendered.

createDocumentationTask

public CompletionTask createDocumentationTask()

Description copied from interface: CompletionItem

Returns a task used to obtain a documentation associated with the item if there is any.

Specified by:

createDocumentationTask in interface CompletionItem

createToolTipTask

public CompletionTask createToolTipTask()

Description copied from interface: CompletionItem

Returns a task used to obtain a tooltip hint associated with the item if there is any.

Specified by:

createToolTipTask in interface CompletionItem

instantSubstitution

public boolean instantSubstitution(javax.swing.text.JTextComponent component)

Description copied from interface: CompletionItem

When enabled for the item the instant substitution should process the item in the same way like when the item is displayed and Enter key gets pressed by the user.
Instant substitution is invoked when there would be just a single item displayed in the completion popup window.
The implementation can invoke the CompletionItem.defaultAction(JTextComponent) if necessary.
This method gets invoked from AWT thread.

Specified by:

instantSubstitution in interface CompletionItem

Parameters:

component - non-null text component for which the completion was invoked.

Returns:

true if the instant substitution was successfully done. false means that the instant substitution should not be done for this item and the completion item should normally be displayed.

getSortPriority

public int getSortPriority()

Description copied from interface: CompletionItem

Returns the item's priority. A lower value means a lower index of the item in the completion result list.

Specified by:

getSortPriority in interface CompletionItem

getSortText

public java.lang.CharSequence getSortText()

Description copied from interface: CompletionItem

Returns a text used to sort items alphabetically.

Specified by:

getSortText in interface CompletionItem

getInsertPrefix

public java.lang.CharSequence getInsertPrefix()

Description copied from interface: CompletionItem

Returns a text used for finding of a longest common prefix after the TAB gets pressed or when the completion is opened explicitly.
The completion infrastructure will evaluate the insert prefixes of all the items present in the visible result and finds the longest common prefix.

Generally the returned text does not need to contain all the information that gets inserted when the item is selected.
For example in java completion the field name should be returned for fields or a method name for methods (but not parameters) or a non-FQN name for classes.

Specified by:

getInsertPrefix in interface CompletionItem

Returns:

non-null character sequence containing the insert prefix.
Returning an empty string will effectively disable the TAB completion as the longest common prefix will be empty.