blob: a99d01ce82e2756c9a4cf394d85ceecc813141d9 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
|
/*******************************************************************************
* Copyright (c) 2006, 2008 IBM Corporation and others.
*
* This program and the accompanying materials
* are made available under the terms of the Eclipse Public License 2.0
* which accompanies this distribution, and is available at
* https://www.eclipse.org/legal/epl-2.0/
*
* SPDX-License-Identifier: EPL-2.0
*
* Contributors:
* IBM Corporation - initial API and implementation
*******************************************************************************/
package org.eclipse.jface.text.quickassist;
import org.eclipse.swt.graphics.Color;
import org.eclipse.jface.preference.JFacePreferences;
import org.eclipse.jface.text.IInformationControlCreator;
import org.eclipse.jface.text.contentassist.ICompletionListener;
import org.eclipse.jface.text.source.Annotation;
import org.eclipse.jface.text.source.ISourceViewer;
import org.eclipse.jface.text.source.ISourceViewerExtension3;
/**
* An <code>IQuickAssistAssistant</code> provides support for quick fixes and quick
* assists.
* The quick assist assistant is a {@link ISourceViewer} add-on. Its
* purpose is to propose, display, and insert quick assists and quick fixes
* available at the current source viewer's quick assist invocation context.
* <p>
* The quick assist assistant can be configured with a {@link IQuickAssistProcessor}
* which provides the possible quick assist and quick fix completions.
* </p>
* In order to provide backward compatibility for clients of
* <code>IQuickAssistAssistant</code>, extension interfaces are used to
* provide a means of evolution. The following extension interfaces exist:
* <ul>
* <li>{@link IQuickAssistAssistantExtension} since version 3.4 introducing the
* following function:
* <ul>
* <li>allows to get a handler for the given command identifier</li>
* <li>allows to enable support for colored labels in the proposal popup</li>
* </ul>
* </li>
* </p>
* <p>
* The interface can be implemented by clients. By default, clients use
* {@link QuickAssistAssistant} as the standard
* implementer of this interface.
* </p>
*
* @see ISourceViewer
* @see IQuickAssistProcessor
* @see IQuickAssistAssistantExtension
* @since 3.2
*/
public interface IQuickAssistAssistant {
/**
* Installs quick assist support on the given source viewer.
* <p>
* <strong>Note:</strong> This quick assist assistant will only be able to query the invocation context
* if <code>sourceViewer</code> also implements {@link ISourceViewerExtension3}.
* </p>
*
* @param sourceViewer the source viewer on which quick assist will work
*/
void install(ISourceViewer sourceViewer);
/**
* Sets the information control creator for the additional information control.
*
* @param creator the information control creator for the additional information control
*/
void setInformationControlCreator(IInformationControlCreator creator);
/**
* Uninstalls quick assist support from the source viewer it has
* previously be installed on.
*/
void uninstall();
/**
* Shows all possible quick fixes and quick assists at the viewer's cursor position.
*
* @return an optional error message if no proposals can be computed
*/
String showPossibleQuickAssists();
/**
* Registers a given quick assist processor for a particular content type. If there is already
* a processor registered, the new processor is registered instead of the old one.
*
* @param processor the quick assist processor to register, or <code>null</code> to remove
* an existing one
*/
void setQuickAssistProcessor(IQuickAssistProcessor processor);
/**
* Returns the quick assist processor to be used for the given content type.
*
* @return the quick assist processor or <code>null</code> if none exists
*/
IQuickAssistProcessor getQuickAssistProcessor();
/**
* Tells whether this assistant has a fix for the given annotation.
* <p>
* <strong>Note:</strong> This test must be fast and optimistic i.e. it is OK to return
* <code>true</code> even though there might be no quick fix.
* </p>
*
* @param annotation the annotation
* @return <code>true</code> if the assistant has a fix for the given annotation
*/
boolean canFix(Annotation annotation);
/**
* Tells whether this assistant has assists for the given invocation context.
*
* @param invocationContext the invocation context
* @return <code>true</code> if the assistant has a fix for the given annotation
*/
boolean canAssist(IQuickAssistInvocationContext invocationContext);
/**
* Sets the proposal selector's background color.
* <p>
* <strong>Note:</strong> As of 3.4, you should only call this
* method if you want to override the {@link JFacePreferences#CONTENT_ASSIST_BACKGROUND_COLOR}.
* </p>
*
* @param background the background color
*/
void setProposalSelectorBackground(Color background);
/**
* Sets the proposal's foreground color.
* <p>
* <strong>Note:</strong> As of 3.4, you should only call this
* method if you want to override the {@link JFacePreferences#CONTENT_ASSIST_FOREGROUND_COLOR}.
* </p>
*
* @param foreground the foreground color
*/
void setProposalSelectorForeground(Color foreground);
/**
* Adds a completion listener that will be informed before proposals are computed.
*
* @param listener the listener
*/
void addCompletionListener(ICompletionListener listener);
/**
* Removes a completion listener.
*
* @param listener the listener to remove
*/
void removeCompletionListener(ICompletionListener listener);
/**
* Enables displaying a status line below the proposal popup. The default is not to show the
* status line. The contents of the status line may be set via {@link #setStatusMessage(String)}.
*
* @param show <code>true</code> to show a message line, <code>false</code> to not show one.
*/
public void setStatusLineVisible(boolean show);
/**
* Sets the caption message displayed at the bottom of the completion proposal popup.
*
* @param message the message
*/
public void setStatusMessage(String message);
}
|
