public class ContentAssistant extends Object implements IContentAssistant, IContentAssistantExtension, IContentAssistantExtension2, IContentAssistantExtension3, IWidgetTokenKeeper, IWidgetTokenKeeperExtension
IContentAssistant interface. Usually, clients
instantiate this class and configure it before using it.| Modifier and Type | Field and Description |
|---|---|
static String |
STORE_SIZE_X
Dialog store constants.
|
static String |
STORE_SIZE_Y |
static int |
WIDGET_PRIORITY
The popup priority: > linked position proposals and hover pop-ups.
|
CONTEXT_INFO_ABOVE, CONTEXT_INFO_BELOW, PROPOSAL_OVERLAY, PROPOSAL_REMOVE, PROPOSAL_STACKED| Constructor and Description |
|---|
ContentAssistant()
Creates a new content assistant.
|
| Modifier and Type | Method and Description |
|---|---|
void |
addCompletionListener(ICompletionListener listener)
Adds a completion listener that will be informed before proposals are computed.
|
String |
completePrefix()
Inserts the common prefix of the available completions.
|
protected void |
contextInformationClosed()
Callback to signal this content assistant that the presentation of the context information
has been stopped.
|
void |
enableAutoActivation(boolean enabled)
Enables the content assistant's auto activation mode.
|
void |
enableAutoInsert(boolean enabled)
Enables the content assistant's auto insertion mode.
|
void |
enablePrefixCompletion(boolean enabled)
Sets the prefix completion property.
|
IContentAssistProcessor |
getContentAssistProcessor(String contentType)
Returns the content assist processor to be used for the given content type.
|
String |
getDocumentPartitioning()
Returns the document partitioning this content assistant is using.
|
boolean |
hasProposalPopupFocus()
Returns whether the content assistant proposal popup has the focus.
|
protected void |
hide()
Hides any open pop-ups.
|
protected void |
install() |
protected void |
install(IContentAssistSubjectControl contentAssistSubjectControl) |
void |
install(ITextViewer textViewer)
Installs content assist support on the given text viewer.
|
protected void |
possibleCompletionsClosed()
Callback to signal this content assistant that the presentation of the possible completions
has been stopped.
|
void |
removeCompletionListener(ICompletionListener listener)
Removes a completion listener.
|
boolean |
requestWidgetToken(IWidgetTokenOwner owner)
The given widget token owner requests the widget token from this token
keeper.
|
boolean |
requestWidgetToken(IWidgetTokenOwner owner,
int priority)
The given widget token owner requests the widget token from
this token keeper.
|
protected Point |
restoreCompletionProposalPopupSize()
Restores the content assist pop-up's size.
|
void |
setAutoActivationDelay(int delay)
Sets the delay after which the content assistant is automatically invoked if the cursor is
behind an auto activation character.
|
void |
setContentAssistProcessor(IContentAssistProcessor processor,
String contentType)
Registers a given content assist processor for a particular content type.
|
void |
setContextInformationPopupBackground(Color background)
Sets the context information popup's background color.
|
void |
setContextInformationPopupForeground(Color foreground)
Sets the context information popup's foreground color.
|
void |
setContextInformationPopupOrientation(int orientation)
Sets the context information popup's orientation.
|
void |
setContextSelectorBackground(Color background)
Sets the context selector's background color.
|
void |
setContextSelectorForeground(Color foreground)
Sets the context selector's foreground color.
|
void |
setDocumentPartitioning(String partitioning)
Sets the document partitioning this content assistant is using.
|
void |
setEmptyMessage(String message)
Sets the text to be shown if no proposals are available and
empty lists are displayed. |
boolean |
setFocus(IWidgetTokenOwner owner)
Requests the receiver to give focus to its popup shell, hover, or similar.
|
void |
setInformationControlCreator(IInformationControlCreator creator)
Sets the information control creator for the additional information control.
|
void |
setProposalPopupOrientation(int orientation)
Sets the proposal pop-ups' orientation.
|
void |
setProposalSelectorBackground(Color background)
Sets the proposal selector's background color.
|
void |
setProposalSelectorForeground(Color foreground)
Sets the proposal's foreground color.
|
void |
setRepeatedInvocationMode(boolean cycling)
Enables repeated invocation mode, which will trigger re-computation of the proposals when
code assist is executed repeatedly.
|
void |
setRepeatedInvocationTrigger(KeySequence sequence)
Sets the key sequence to listen for in repeated invocation mode.
|
void |
setRestoreCompletionProposalSize(IDialogSettings dialogSettings)
Tells this information control manager to open the information control with the values
contained in the given dialog settings and to store the control's last valid size in the
given dialog settings.
|
void |
setShowEmptyList(boolean showEmpty)
Enables displaying an empty completion proposal pop-up.
|
void |
setStatusLineVisible(boolean show)
Enables displaying a status line below the proposal popup.
|
void |
setStatusMessage(String message)
Sets the caption message displayed at the bottom of the completion proposal popup.
|
String |
showContextInformation()
Shows context information for the content at the viewer's cursor position.
|
String |
showPossibleCompletions()
Shows all possible completions of the content at the viewer's cursor position.
|
protected void |
storeCompletionProposalPopupSize()
Stores the content assist pop-up's size.
|
void |
uninstall()
Uninstalls content assist support from the text viewer it has
previously be installed on.
|
public static final String STORE_SIZE_X
public static final String STORE_SIZE_Y
public static final int WIDGET_PRIORITY
20;public ContentAssistant()
public void setDocumentPartitioning(String partitioning)
partitioning - the document partitioning for this content assistantpublic String getDocumentPartitioning()
IContentAssistantExtensiongetDocumentPartitioning in interface IContentAssistantExtensionpublic void setContentAssistProcessor(IContentAssistProcessor processor, String contentType)
processor - the content assist processor to register, or null to remove
an existing onecontentType - the content type under which to registerpublic IContentAssistProcessor getContentAssistProcessor(String contentType)
IContentAssistantgetContentAssistProcessor in interface IContentAssistantcontentType - the type of the content for which this
content assistant is to be requestednull if none exists for the specified content typepublic void enableAutoActivation(boolean enabled)
enabled - indicates whether auto activation is enabled or notpublic void enableAutoInsert(boolean enabled)
enabled - indicates whether auto insertion is enabled or notpublic void setAutoActivationDelay(int delay)
delay - the auto activation delaypublic void setProposalPopupOrientation(int orientation)
proposal popup windows should overlay each other
any currently shown proposal popup should be closed
proposal popup windows should be vertical stacked, with no overlap, beneath the line containing the current cursor location
orientation - the popup's orientationpublic void setContextInformationPopupOrientation(int orientation)
context information popup should always appear above the line containing the current cursor location
context information popup should always appear below the line containing the current cursor location
orientation - the popup's orientationpublic void setContextInformationPopupBackground(Color background)
background - the background colorpublic void setContextInformationPopupForeground(Color foreground)
foreground - the foreground colorpublic void setProposalSelectorBackground(Color background)
background - the background colorpublic void setProposalSelectorForeground(Color foreground)
foreground - the foreground colorpublic void setContextSelectorBackground(Color background)
background - the background colorpublic void setContextSelectorForeground(Color foreground)
foreground - the foreground colorpublic void setInformationControlCreator(IInformationControlCreator creator)
creator - the information control creator for the additional information controlprotected void install(IContentAssistSubjectControl contentAssistSubjectControl)
public void install(ITextViewer textViewer)
IContentAssistantinstall in interface IContentAssistanttextViewer - the text viewer on which content assist will workprotected void install()
public void uninstall()
IContentAssistantuninstall in interface IContentAssistantpublic String showPossibleCompletions()
IContentAssistantshowPossibleCompletions in interface IContentAssistantpublic String completePrefix()
IContentAssistantExtensionIContentAssistant.showPossibleCompletions().completePrefix in interface IContentAssistantExtensionprotected void possibleCompletionsClosed()
public String showContextInformation()
IContentAssistantshowContextInformation in interface IContentAssistantprotected void contextInformationClosed()
public boolean requestWidgetToken(IWidgetTokenOwner owner)
IWidgetTokenKeepertrue if the token is released by this
token keeper. Note, the keeper must not call
releaseWidgetToken(IWidgetTokenKeeper) explicitly.
Replaced by
IWidgetTokenKeeperExtension.requestWidgetToken(IWidgetTokenOwner, int).
requestWidgetToken in interface IWidgetTokenKeeperowner - the token ownertrue if token has been released false
otherwisepublic boolean requestWidgetToken(IWidgetTokenOwner owner, int priority)
IWidgetTokenKeeperExtensiontrue if the token is released
by this token keeper. Note, the keeper must not call
releaseWidgetToken(IWidgetTokenKeeper) explicitly.
The general contract is that the receiver should release the token
if priority exceeds the receiver's priority.
requestWidgetToken in interface IWidgetTokenKeeperExtensionowner - the token ownerpriority - the priority of the requesttrue if token has been released false otherwisepublic boolean setFocus(IWidgetTokenOwner owner)
IWidgetTokenKeeperExtensionsetFocus in interface IWidgetTokenKeeperExtensionowner - the token ownertrue if the receiver tried to take focus, false if it did not.protected void hide()
public void setRestoreCompletionProposalSize(IDialogSettings dialogSettings)
Note: This API is only valid if the information control implements
IInformationControlExtension3. Not following this restriction
will later result in an UnsupportedOperationException.
The constants used to store the values are:
dialogSettings - protected void storeCompletionProposalPopupSize()
protected Point restoreCompletionProposalPopupSize()
public void enablePrefixCompletion(boolean enabled)
enabled - true to enable prefix completion, false to
disablepublic boolean hasProposalPopupFocus()
true if the proposal popup has the focuspublic void addCompletionListener(ICompletionListener listener)
IContentAssistantExtension2addCompletionListener in interface IContentAssistantExtension2listener - the listenerpublic void removeCompletionListener(ICompletionListener listener)
IContentAssistantExtension2removeCompletionListener in interface IContentAssistantExtension2listener - the listener to removepublic void setRepeatedInvocationMode(boolean cycling)
IContentAssistantExtension2false.setRepeatedInvocationMode in interface IContentAssistantExtension2cycling - true to enable repetition mode, false to disablepublic void setShowEmptyList(boolean showEmpty)
IContentAssistantExtension2setShowEmptyList in interface IContentAssistantExtension2showEmpty - true to show empty listspublic void setStatusLineVisible(boolean show)
IContentAssistantExtension2IContentAssistantExtension2.setStatusMessage(String).setStatusLineVisible in interface IContentAssistantExtension2show - true to show a message line, false to not show one.public void setStatusMessage(String message)
IContentAssistantExtension2setStatusMessage in interface IContentAssistantExtension2message - the messagepublic void setEmptyMessage(String message)
IContentAssistantExtension2empty lists are displayed.setEmptyMessage in interface IContentAssistantExtension2message - the text for the empty listpublic void setRepeatedInvocationTrigger(KeySequence sequence)
IContentAssistantExtension3setRepeatedInvocationTrigger in interface IContentAssistantExtension3sequence - the key sequence used for the repeated invocation mode or null if noneGuidelines for using Eclipse APIs. Copyright (c) IBM Corp. and others 2000, 2006. All rights reserved.