JAL-2933 pass viewport in Finder constructor, find acts on viewport selection if any
[jalview.git] / src / jalview / api / FinderI.java
index a1a3efd..19f6136 100644 (file)
@@ -1,7 +1,6 @@
 package jalview.api;
 
 import jalview.datamodel.SearchResultsI;
-import jalview.datamodel.SequenceGroup;
 import jalview.datamodel.SequenceI;
 
 import java.util.List;
@@ -16,7 +15,7 @@ public interface FinderI
    * Performs a find for the given search string (interpreted as a regular
    * expression). Search may optionally be case-sensitive, and may optionally
    * including match in sequence description (sequence id is always searched).
-   * If <code>selection</code> is not null, then the find is restricted to the
+   * If the viewport has an active selection, then the find is restricted to the
    * selection region. Sequences matched by id or description can be retrieved
    * by getIdMatches(), and matched residue patterns by getSearchResults().
    * 
@@ -25,26 +24,25 @@ public interface FinderI
    * @param searchDescription
    * @return
    */
-  void findAll(String theSearchString, SequenceGroup selection,
-          boolean caseSensitive, boolean searchDescription);
+  void findAll(String theSearchString, boolean caseSensitive,
+          boolean searchDescription);
 
   /**
    * Finds the next match for the given search string (interpreted as a regular
    * expression), starting from the position after the last match found. Search
    * may optionally be case-sensitive, and may optionally including match in
-   * sequence description (sequence id is always searched). If
-   * <code>selection</code> is not null, then the find is restricted to the
-   * selection region. Sequences matched by id or description can be retrieved
-   * by getIdMatches(), and matched residue patterns by getSearchResults().
+   * sequence description (sequence id is always searched). If the viewport has
+   * an active selection, then the find is restricted to the selection region.
+   * Sequences matched by id or description can be retrieved by getIdMatches(),
+   * and matched residue patterns by getSearchResults().
    * 
    * @param theSearchString
-   * @param selection
    * @param caseSensitive
    * @param searchDescription
    * @return
    */
-  void findNext(String theSearchString, SequenceGroup selection,
-          boolean caseSensitive, boolean searchDescription);
+  void findNext(String theSearchString, boolean caseSensitive,
+          boolean searchDescription);
 
   /**
    * Returns the (possibly empty) list of sequences matched on sequence name or