Async frame preparation for Preview with support if selection.

chrome/renderer/printing/print_web_view_helper.h

 // Copyright (c) 2012 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 CHROME_RENDERER_PRINTING_PRINT_WEB_VIEW_HELPER_H_
 #define CHROME_RENDERER_PRINTING_PRINT_WEB_VIEW_HELPER_H_
 
 #include <vector>
 
 #include "base/gtest_prod_util.h"
@@ skipping 120 matching lines @@
       bool source_is_html,
       const base::DictionaryValue& job_settings,
       const PrintMsg_Print_Params& params);
 
   // Initiate print preview.
   void OnInitiatePrintPreview();
 
   // Start the process of generating a print preview using |settings|.
   void OnPrintPreview(const base::DictionaryValue& settings);
 
+  // Prepare frame for creating preview document.
+  void PrepareFrameForPreviewDocument();
+
+  // Continue creating preview document.
+  void OnFramePreparedForPreviewDocument();
+
   // Initialize the print preview document.
   bool CreatePreviewDocument();
 
   // Renders a print preview page. |page_number| is 0-based.
   // Returns true if print preview should continue, false on failure.
   bool RenderPreviewPage(int page_number,
                          const PrintMsg_Print_Params& print_params);
 
   // Finalize the print ready preview document.
   bool FinalizePrintReadyDocument();
@@ skipping 194 matching lines @@
 
     // Initializes the print preview context. Need to be called to set
     // the |web_frame| / |web_node| to generate the print preview for.
     void InitWithFrame(WebKit::WebFrame* web_frame);
     void InitWithNode(const WebKit::WebNode& web_node);
 
     // Does bookkeeping at the beginning of print preview.
     void OnPrintPreview();
 
     // Create the print preview document. |pages| is empty to print all pages.
-    bool CreatePreviewDocument(const PrintMsg_Print_Params& params,
-                               const std::vector<int>& pages,
-                               bool ignore_css_margins);
+    bool CreatePreviewDocument(PrepareFrameAndViewForPrint* prepared_frame,

[Lei Zhang, 2013/01/26 08:40:36]

Mention this takes ownership of |prepared_frame|.

[Vitaly Buka (NO REVIEWS), 2013/01/26 10:29:30]

Done.

+                               const std::vector<int>& pages);
 
     // Called after a page gets rendered. |page_time| is how long the
     // rendering took.
     void RenderedPreviewPage(const base::TimeDelta& page_time);
 
     // Updates the print preview context when the required pages are rendered.
     void AllPagesRendered();
 
     // Finalizes the print ready preview document.
     void FinalizePrintReadyDocument();
 
     // Cleanup after print preview finishes.
     void Finished();
 
     // Cleanup after print preview fails.
     void Failed(bool report_error);
 
     // Helper functions
     int GetNextPageNumber();
     bool IsRendering() const;
     bool IsModifiable() const;
+    bool HasSelection() const;
     bool IsLastPageOfPrintReadyMetafile() const;
     bool IsFinalPageRendered() const;
 
     // Setters
     void set_generate_draft_pages(bool generate_draft_pages);
     void set_error(enum PrintPreviewErrorBuckets error);
 
     // Getters
-    WebKit::WebFrame* frame();
-    const WebKit::WebNode& node() const;
+    WebKit::WebFrame* prepared_frame();

[Lei Zhang, 2013/01/26 08:40:36]

Please mention the difference between the source and prepared versions.

[Vitaly Buka (NO REVIEWS), 2013/01/26 10:29:30]

Done.

+    const WebKit::WebNode& prepared_node() const;
+    WebKit::WebFrame* source_frame();
+    const WebKit::WebNode& source_node() const;
     int total_page_count() const;
     bool generate_draft_pages() const;
     PreviewMetafile* metafile();
     gfx::Size GetPrintCanvasSize() const;
     int last_error() const;
 
    private:
     enum State {
       UNINITIALIZED,  // Not ready to render.
       INITIALIZED,    // Ready to render.
       RENDERING,      // Rendering.
       DONE            // Finished rendering.
     };
 
     // Reset some of the internal rendering context.
     void ClearContext();
 
     // Specifies what to render for print preview.
-    WebKit::WebFrame* frame_;
-    WebKit::WebNode node_;
+    WebKit::WebFrame* source_frame_;
+    WebKit::WebNode source_node_;
 
     scoped_ptr<PrepareFrameAndViewForPrint> prep_frame_view_;
     scoped_ptr<PreviewMetafile> metafile_;
 
-    // Total page count in the renderer.
-    int total_page_count_;
-
     // The current page to render.
     int current_page_index_;
 
     // List of page indices that need to be rendered.
     std::vector<int> pages_to_render_;
 
     // True, when draft pages needs to be generated.
     bool generate_draft_pages_;
 
     // Specifies the total number of pages in the print ready metafile.
     int print_ready_metafile_page_count_;
 
     base::TimeDelta document_render_time_;
     base::TimeTicks begin_time_;
 
     enum PrintPreviewErrorBuckets error_;
 
     State state_;
   };
 
   bool print_node_in_progress_;
   PrintPreviewContext print_preview_context_;
   DISALLOW_COPY_AND_ASSIGN(PrintWebViewHelper);
 };
 
 }  // namespace printing
 
 #endif  // CHROME_RENDERER_PRINTING_PRINT_WEB_VIEW_HELPER_H_