|
Eclipse Platform Release 3.1 |
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.eclipse.jface.text.contentassist.ContentAssistant
The standard implementation of the IContentAssistant
interface.
Usually, clients instantiate this class and configure it before using it.
Field Summary | |
---|---|
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. |
Fields inherited from interface org.eclipse.jface.text.contentassist.IContentAssistant |
---|
CONTEXT_INFO_ABOVE, CONTEXT_INFO_BELOW, PROPOSAL_OVERLAY, PROPOSAL_REMOVE, PROPOSAL_STACKED |
Constructor Summary | |
---|---|
ContentAssistant()
Creates a new content assistant. |
Method Summary | |
---|---|
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. |
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. |
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 |
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. |
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. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static final String STORE_SIZE_X
public static final String STORE_SIZE_Y
public static final int WIDGET_PRIORITY
20
;
Constructor Detail |
public ContentAssistant()
Method Detail |
public void setDocumentPartitioning(String partitioning)
partitioning
- the document partitioning for this content assistantpublic String getDocumentPartitioning()
IContentAssistantExtension
getDocumentPartitioning
in interface IContentAssistantExtension
public 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)
IContentAssistant
getContentAssistProcessor
in interface IContentAssistant
contentType
- the type of the content for which this
content assistant is to be requested
null
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)
IContentAssistant
install
in interface IContentAssistant
textViewer
- the text viewer on which content assist will workprotected void install()
public void uninstall()
IContentAssistant
uninstall
in interface IContentAssistant
public String showPossibleCompletions()
IContentAssistant
showPossibleCompletions
in interface IContentAssistant
public String completePrefix()
IContentAssistantExtension
IContentAssistant.showPossibleCompletions()
.
completePrefix
in interface IContentAssistantExtension
protected void possibleCompletionsClosed()
public String showContextInformation()
IContentAssistant
showContextInformation
in interface IContentAssistant
protected void contextInformationClosed()
public boolean requestWidgetToken(IWidgetTokenOwner owner)
IWidgetTokenKeeper
true
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 IWidgetTokenKeeper
owner
- the token owner
true
if token has been released false
otherwisepublic boolean requestWidgetToken(IWidgetTokenOwner owner, int priority)
IWidgetTokenKeeperExtension
true
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 IWidgetTokenKeeperExtension
owner
- the token ownerpriority
- the priority of the request
true
if token has been released false
otherwisepublic boolean setFocus(IWidgetTokenOwner owner)
IWidgetTokenKeeperExtension
setFocus
in interface IWidgetTokenKeeperExtension
owner
- the token owner
true
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 focus
|
Eclipse Platform Release 3.1 |
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Guidelines for using Eclipse APIs.
Copyright (c) IBM Corp. and others 2000, 2005. All rights reserved.