public interface IFindReplaceTarget
The two main methods are findAndSelect and
replaceSelection. The target does not provide any way to
modify the content other than replacing the selection.
In order to provide backward compatibility for clients of
IFindReplaceTarget, extension interfaces are used as a means
of evolution. The following extension interfaces exist:
IFindReplaceTargetExtension since version
2.0 introducing the notion of find/replace session and of a find/replace
scope. In additions, in allows clients to replace all occurrences of a given
find query.IFindReplaceTargetExtension3 since
version 3.0 allowing clients to specify search queries as regular
expressions.
Clients of a IFindReplaceTarget that also implements the
IFindReplaceTargetExtension have to indicate the start of a find/replace
session before using the target and to indicate the end of the session when the
target is no longer used.
| Modifier and Type | Method and Description |
|---|---|
boolean |
canPerformFind()
Returns whether a find operation can be performed.
|
int |
findAndSelect(int widgetOffset,
String findString,
boolean searchForward,
boolean caseSensitive,
boolean wholeWord)
Searches for a string starting at the given widget offset and using the specified search
directives.
|
Point |
getSelection()
Returns the currently selected range of characters as a offset and length in widget coordinates.
|
String |
getSelectionText()
Returns the currently selected characters as a string.
|
boolean |
isEditable()
Returns whether this target can be modified.
|
void |
replaceSelection(String text)
Replaces the currently selected range of characters with the given text.
|
boolean canPerformFind()
int findAndSelect(int widgetOffset,
String findString,
boolean searchForward,
boolean caseSensitive,
boolean wholeWord)
Replaced by IFindReplaceTargetExtension3.findAndSelect(int, String, boolean, boolean, boolean, boolean).
widgetOffset - the widget offset at which searching startsfindString - the string which should be foundsearchForward - true searches forward, false backwardscaseSensitive - true performs a case sensitive search, false an insensitive searchwholeWord - if true only occurrences are reported in which the findString stands as a word by itselfPoint getSelection()
String getSelectionText()
boolean isEditable()
true if target can be modifiedvoid replaceSelection(String text)
Replaced by IFindReplaceTargetExtension3.replaceSelection(String, boolean).
text - the substitution textGuidelines for using Eclipse APIs. Copyright (c) IBM Corp. and others 2000, 2006. All rights reserved.