Chromium Code Reviews| Index: content/browser/find_request_manager.h |
| diff --git a/content/browser/find_request_manager.h b/content/browser/find_request_manager.h |
| new file mode 100644 |
| index 0000000000000000000000000000000000000000..c984d9eb23c48103f56d7b461ef1632d49f74309 |
| --- /dev/null |
| +++ b/content/browser/find_request_manager.h |
| @@ -0,0 +1,132 @@ |
| +// Copyright 2016 The Chromium Authors. All rights reserved. |
| +// Use of this source code is governed by a BSD-style license that can be |
| +// found in the LICENSE file. |
| + |
| +#ifndef CONTENT_BROWSER_FIND_REQUEST_MANAGER_H_ |
| +#define CONTENT_BROWSER_FIND_REQUEST_MANAGER_H_ |
| + |
| +#include <set> |
| +#include <vector> |
| + |
| +#include "content/public/common/stop_find_action.h" |
| +#include "third_party/WebKit/public/web/WebFindOptions.h" |
| +#include "ui/gfx/geometry/rect.h" |
| +#include "ui/gfx/geometry/rect_f.h" |
| + |
| +namespace content { |
| + |
| +class RenderFrameHost; |
| +class WebContentsImpl; |
| + |
| +// FindRequestManager manages all of the find-in-page requests/replies |
| +// initiated/received through a WebContents. It coordinates searching across |
| +// multiple (potentially out-of-process) frames, handles the aggregation of find |
| +// results from each frame, and facilitates active match traversal. It is |
| +// instantiated once per WebContents, and is owned by that WebContents. |
| +// |
| +// TODO(paulmeyer): FindRequestManager is currently incomplete and does not do |
| +// all of these things yet, but will soon. |
| +class FindRequestManager { |
| + public: |
| + explicit FindRequestManager(WebContentsImpl* web_contents); |
| + ~FindRequestManager(); |
| + |
| + // Initiates a find operation for |search_text| with the options specified in |
| + // |options|. |request_id| uniquely identifies the find request. |
| + void Find(int request_id, |
| + const base::string16& search_text, |
| + const blink::WebFindOptions& options); |
| + |
| + // Stops the active find session and clears the general highlighting of the |
| + // matches. |action| determines whether the last active match (if any) will be |
| + // activated, cleared, or remain highlighted. |
| + void StopFinding(StopFindAction action); |
| + |
| + // Called when a reply is received from a frame with the results from a |
| + // find request. |
| + void OnFindReply(RenderFrameHost* rfh, |
| + int request_id, |
| + int number_of_matches, |
| + const gfx::Rect& selection_rect, |
| + int active_match_ordinal, |
| + bool final_update); |
| + |
| +#if defined(OS_ANDROID) |
| + // Selects and zooms to the find result nearest to the point (x,y) defined in |
| + // find-in-page coordinates. |
| + void ActivateNearestFindResult(float x, float y); |
| + |
| + // Requests the rects of the current find matches from the renderer process. |
| + void RequestFindMatchRects(int current_version); |
| + |
| + // Called when a reply is received in response to a request for find match |
| + // rects. |
| + void OnFindMatchRectsReply(RenderFrameHost* rfh, |
| + int version, |
| + const std::vector<gfx::RectF>& rects, |
| + const gfx::RectF& active_rect); |
| +#endif |
| + |
| + private: |
| + // The request data for a single find request. |
| + struct FindRequest { |
| + // The find request ID that uniquely identifies this find request. |
| + int id; |
| + |
| + // The text that is being searched for in this find request. |
| + base::string16 search_text; |
| + |
| + // The set of find options in effect for this find request. |
| + blink::WebFindOptions options; |
| + }; |
| + |
| + // Send a find IPC containing the find request |request| to the RenderFrame |
| + // associated with |rfh|. |
| + void SendFindIPC(FindRequest request, RenderFrameHost* rfh); |
|
ncarter (slow)
2016/04/11 21:27:35
Usually a struct like this would be passed by cons
paulmeyer
2016/04/12 17:54:25
Right, I didn't do that because this function will
|
| + |
| + // Send a stop finding IPC to the RenderFrame associated with |rfh|. |
| + void SendStopFindingIPC(StopFindAction action, RenderFrameHost* rfh) const; |
| + |
| + // Reset all of the per-session state for a new find-in-page session. |
| + void Reset(const FindRequest& initial_request); |
| + |
| + // Send the find results (as they currently are) to the WebContents. |
| + void NotifyFindReply(int request_id, bool final_update) const; |
| + |
| +#if defined(OS_ANDROID) |
| + // Request the latest find match rects from a frame. |
| + void SendFindMatchRectsIPC(RenderFrameHost* rfh); |
| + |
| + // State related to FindMatchRects requests. |
| + struct FindMatchRectsState { |
| + // The latest find match rects version known by the requester. |
| + int request_version; |
| + } match_rects_; |
| +#endif |
| + |
| + // The WebContents that owns this FindRequestManager. |
| + WebContentsImpl* const contents_; |
| + |
| + // The request ID of the initial find request in the current find-in-page |
| + // session, which uniquely identifies this session. Request IDs are included |
| + // in all find-related IPCs, which allows reply IPCs containing results from |
| + // previous sessions (with |request_id| < |current_session_id_|) to be easily |
| + // identified and ignored. |
| + int current_session_id_; |
| + |
| + // The current find request. |
| + FindRequest current_request_; |
| + |
| + // The total number of matches found in the current find-in-page session. |
| + int number_of_matches_; |
| + |
| + // The overall active match ordinal for the current find-in-page session. |
| + int active_match_ordinal_; |
| + |
| + // The rectangle around the active match, in screen coordinates. |
| + gfx::Rect selection_rect_; |
| +}; |
| + |
| +} // namespace content |
| + |
| +#endif // CONTENT_BROWSER_FIND_REQUEST_MANAGER_H_ |