| Index: chrome/renderer/printing/print_web_view_helper.h
|
| diff --git a/chrome/renderer/printing/print_web_view_helper.h b/chrome/renderer/printing/print_web_view_helper.h
|
| index 95b46048b8efe6774074413982da722b93c35e33..2039c8da4b8abeec0401b0e0fc5dbd89ac08debe 100644
|
| --- a/chrome/renderer/printing/print_web_view_helper.h
|
| +++ b/chrome/renderer/printing/print_web_view_helper.h
|
| @@ -1,510 +1,462 @@
|
| -// 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"
|
| -#include "base/memory/scoped_ptr.h"
|
| -#include "base/shared_memory.h"
|
| -#include "base/time.h"
|
| -#include "content/public/renderer/render_view_observer.h"
|
| -#include "content/public/renderer/render_view_observer_tracker.h"
|
| -#include "printing/metafile_impl.h"
|
| -#include "third_party/WebKit/Source/Platform/chromium/public/WebCanvas.h"
|
| -#include "third_party/WebKit/Source/WebKit/chromium/public/WebFrameClient.h"
|
| -#include "third_party/WebKit/Source/WebKit/chromium/public/WebNode.h"
|
| -#include "third_party/WebKit/Source/WebKit/chromium/public/WebPrintParams.h"
|
| -#include "third_party/WebKit/Source/WebKit/chromium/public/WebViewClient.h"
|
| -#include "ui/gfx/size.h"
|
| -
|
| -struct PrintMsg_Print_Params;
|
| -struct PrintMsg_PrintPage_Params;
|
| -struct PrintMsg_PrintPages_Params;
|
| -
|
| -namespace base {
|
| -class DictionaryValue;
|
| -}
|
| -
|
| -namespace WebKit {
|
| -class WebFrame;
|
| -class WebView;
|
| -}
|
| -
|
| -namespace printing {
|
| -
|
| -struct PageSizeMargins;
|
| -
|
| -// Class that calls the Begin and End print functions on the frame and changes
|
| -// the size of the view temporarily to support full page printing..
|
| -// Do not serve any events in the time between construction and destruction of
|
| -// this class because it will cause flicker.
|
| -class PrepareFrameAndViewForPrint {
|
| - public:
|
| - // Prints |frame|. If |node| is not NULL, then only that node will be
|
| - // printed.
|
| - PrepareFrameAndViewForPrint(const PrintMsg_Print_Params& print_params,
|
| - WebKit::WebFrame* frame,
|
| - const WebKit::WebNode& node);
|
| - ~PrepareFrameAndViewForPrint();
|
| -
|
| - void UpdatePrintParams(const PrintMsg_Print_Params& print_params);
|
| -
|
| - int GetExpectedPageCount() const {
|
| - return expected_pages_count_;
|
| - }
|
| -
|
| - bool ShouldUseBrowserOverlays() const {
|
| - return use_browser_overlays_;
|
| - }
|
| -
|
| - gfx::Size GetPrintCanvasSize() const;
|
| -
|
| - void FinishPrinting();
|
| -
|
| - private:
|
| - void StartPrinting(const WebKit::WebPrintParams& webkit_print_params);
|
| -
|
| - WebKit::WebFrame* frame_;
|
| - WebKit::WebNode node_to_print_;
|
| - WebKit::WebView* web_view_;
|
| - WebKit::WebPrintParams web_print_params_;
|
| - gfx::Size prev_view_size_;
|
| - gfx::Size prev_scroll_offset_;
|
| - int expected_pages_count_;
|
| - bool use_browser_overlays_;
|
| - bool finished_;
|
| - bool should_print_backgrounds_;
|
| -
|
| - DISALLOW_COPY_AND_ASSIGN(PrepareFrameAndViewForPrint);
|
| -};
|
| -
|
| -// PrintWebViewHelper handles most of the printing grunt work for RenderView.
|
| -// We plan on making print asynchronous and that will require copying the DOM
|
| -// of the document and creating a new WebView with the contents.
|
| -class PrintWebViewHelper
|
| - : public content::RenderViewObserver,
|
| - public content::RenderViewObserverTracker<PrintWebViewHelper>,
|
| - public WebKit::WebViewClient,
|
| - public WebKit::WebFrameClient {
|
| - public:
|
| - explicit PrintWebViewHelper(content::RenderView* render_view);
|
| - virtual ~PrintWebViewHelper();
|
| -
|
| - void PrintNode(const WebKit::WebNode& node);
|
| -
|
| - protected:
|
| - // WebKit::WebViewClient override:
|
| - virtual void didStopLoading();
|
| -
|
| - private:
|
| - friend class PrintWebViewHelperTestBase;
|
| - FRIEND_TEST_ALL_PREFIXES(PrintWebViewHelperTest,
|
| - BlockScriptInitiatedPrinting);
|
| - FRIEND_TEST_ALL_PREFIXES(PrintWebViewHelperTest,
|
| - BlockScriptInitiatedPrintingFromPopup);
|
| - FRIEND_TEST_ALL_PREFIXES(PrintWebViewHelperTest, OnPrintPages);
|
| -
|
| -#if defined(OS_WIN) || defined(OS_MACOSX)
|
| - FRIEND_TEST_ALL_PREFIXES(PrintWebViewHelperTest, PrintLayoutTest);
|
| - FRIEND_TEST_ALL_PREFIXES(PrintWebViewHelperTest, PrintWithIframe);
|
| -#endif // defined(OS_WIN) || defined(OS_MACOSX)
|
| -
|
| - enum PrintingResult {
|
| - OK,
|
| - FAIL_PRINT_INIT,
|
| - FAIL_PRINT,
|
| - FAIL_PREVIEW,
|
| - };
|
| -
|
| - enum PrintPreviewErrorBuckets {
|
| - PREVIEW_ERROR_NONE, // Always first.
|
| - PREVIEW_ERROR_BAD_SETTING,
|
| - PREVIEW_ERROR_METAFILE_COPY_FAILED,
|
| - PREVIEW_ERROR_METAFILE_INIT_FAILED,
|
| - PREVIEW_ERROR_ZERO_PAGES,
|
| - PREVIEW_ERROR_MAC_DRAFT_METAFILE_INIT_FAILED,
|
| - PREVIEW_ERROR_PAGE_RENDERED_WITHOUT_METAFILE,
|
| - PREVIEW_ERROR_UPDATING_PRINT_SETTINGS,
|
| - PREVIEW_ERROR_INVALID_PRINTER_SETTINGS,
|
| - PREVIEW_ERROR_LAST_ENUM // Always last.
|
| - };
|
| -
|
| - enum PrintPreviewRequestType {
|
| - PRINT_PREVIEW_USER_INITIATED_ENTIRE_FRAME,
|
| - PRINT_PREVIEW_USER_INITIATED_CONTEXT_NODE,
|
| - PRINT_PREVIEW_SCRIPTED // triggered by window.print().
|
| - };
|
| -
|
| - // RenderViewObserver implementation.
|
| - virtual bool OnMessageReceived(const IPC::Message& message) OVERRIDE;
|
| - virtual void PrintPage(WebKit::WebFrame* frame, bool user_initiated) OVERRIDE;
|
| -
|
| - // Message handlers ---------------------------------------------------------
|
| -
|
| - // Print the document.
|
| - void OnPrintPages();
|
| -
|
| - // Print the document with the print preview frame/node.
|
| - void OnPrintForSystemDialog();
|
| -
|
| - // Get |page_size| and |content_area| information from
|
| - // |page_layout_in_points|.
|
| - void GetPageSizeAndContentAreaFromPageLayout(
|
| - const PageSizeMargins& page_layout_in_points,
|
| - gfx::Size* page_size,
|
| - gfx::Rect* content_area);
|
| -
|
| - // Update |ignore_css_margins_| based on settings.
|
| - void UpdateFrameMarginsCssInfo(const base::DictionaryValue& settings);
|
| -
|
| - // Returns true if the current destination printer is PRINT_TO_PDF.
|
| - bool IsPrintToPdfRequested(const base::DictionaryValue& settings);
|
| -
|
| - // Returns the print scaling option to retain/scale/crop the source page size
|
| - // to fit the printable area of the paper.
|
| - //
|
| - // We retain the source page size when the current destination printer is
|
| - // SAVE_AS_PDF.
|
| - //
|
| - // We crop the source page size to fit the printable area or we print only the
|
| - // left top page contents when
|
| - // (1) Source is PDF and the user has requested not to fit to printable area
|
| - // via |job_settings|.
|
| - // (2) Source is PDF. This is the first preview request and print scaling
|
| - // option is disabled for initiator renderer plugin.
|
| - //
|
| - // In all other cases, we scale the source page to fit the printable area.
|
| - WebKit::WebPrintScalingOption GetPrintScalingOption(
|
| - 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);
|
| -
|
| - // 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();
|
| -
|
| - // Print / preview the node under the context menu.
|
| - void OnPrintNodeUnderContextMenu();
|
| -
|
| - // Print the pages for print preview. Do not display the native print dialog
|
| - // for user settings. |job_settings| has new print job settings values.
|
| - void OnPrintForPrintPreview(const base::DictionaryValue& job_settings);
|
| -
|
| - void OnPrintingDone(bool success);
|
| -
|
| - // Enable/Disable window.print calls. If |blocked| is true window.print
|
| - // calls will silently fail. Call with |blocked| set to false to reenable.
|
| - void SetScriptedPrintBlocked(bool blocked);
|
| -
|
| - // Main printing code -------------------------------------------------------
|
| -
|
| - void Print(WebKit::WebFrame* frame, const WebKit::WebNode& node);
|
| -
|
| - // Notification when printing is done - signal tear-down/free resources.
|
| - void DidFinishPrinting(PrintingResult result);
|
| -
|
| - // Print Settings -----------------------------------------------------------
|
| -
|
| - // Initialize print page settings with default settings.
|
| - // Used only for native printing workflow.
|
| - bool InitPrintSettings(bool fit_to_paper_size);
|
| -
|
| - // Initialize print page settings with default settings and prepare the frame
|
| - // for print. A new PrepareFrameAndViewForPrint is created to fulfill the
|
| - // request and is filled into the |prepare| argument.
|
| - // Used only for native printing workflow.
|
| - bool InitPrintSettingsAndPrepareFrame(
|
| - WebKit::WebFrame* frame,
|
| - const WebKit::WebNode& node,
|
| - scoped_ptr<PrepareFrameAndViewForPrint>* prepare);
|
| -
|
| - // Update the current print settings with new |passed_job_settings|.
|
| - // |passed_job_settings| dictionary contains print job details such as printer
|
| - // name, number of copies, page range, etc.
|
| - bool UpdatePrintSettings(WebKit::WebFrame* frame,
|
| - const WebKit::WebNode& node,
|
| - const base::DictionaryValue& passed_job_settings);
|
| -
|
| - // Get final print settings from the user.
|
| - // Return false if the user cancels or on error.
|
| - bool GetPrintSettingsFromUser(WebKit::WebFrame* frame,
|
| - const WebKit::WebNode& node,
|
| - int expected_pages_count,
|
| - bool use_browser_overlays);
|
| -
|
| - // Page Printing / Rendering ------------------------------------------------
|
| -
|
| - // Prints all the pages listed in |print_pages_params_|.
|
| - // It will implicitly revert the document to display CSS media type.
|
| - bool PrintPages(WebKit::WebFrame* frame, const WebKit::WebNode& node);
|
| -
|
| - // Prints the page listed in |params|.
|
| -#if defined(USE_X11)
|
| - void PrintPageInternal(const PrintMsg_PrintPage_Params& params,
|
| - const gfx::Size& canvas_size,
|
| - WebKit::WebFrame* frame,
|
| - Metafile* metafile);
|
| -#else
|
| - void PrintPageInternal(const PrintMsg_PrintPage_Params& params,
|
| - const gfx::Size& canvas_size,
|
| - WebKit::WebFrame* frame);
|
| -#endif
|
| -
|
| - // Render the frame for printing.
|
| - bool RenderPagesForPrint(WebKit::WebFrame* frame,
|
| - const WebKit::WebNode& node);
|
| -
|
| - // Platform specific helper function for rendering page(s) to |metafile|.
|
| -#if defined(OS_WIN)
|
| - void RenderPage(const PrintMsg_Print_Params& params,
|
| - int page_number,
|
| - WebKit::WebFrame* frame,
|
| - bool is_preview,
|
| - Metafile* metafile,
|
| - double* scale_factor,
|
| - gfx::Size* page_size_in_dpi,
|
| - gfx::Rect* content_area_in_dpi);
|
| -#elif defined(OS_MACOSX)
|
| - void RenderPage(const PrintMsg_Print_Params& params, int page_number,
|
| - WebKit::WebFrame* frame, bool is_preview,
|
| - Metafile* metafile, gfx::Size* page_size,
|
| - gfx::Rect* content_rect);
|
| -#elif defined(OS_POSIX)
|
| - bool RenderPages(const PrintMsg_PrintPages_Params& params,
|
| - WebKit::WebFrame* frame, const WebKit::WebNode& node,
|
| - std::vector<int>* printed_pages,
|
| - Metafile* metafile);
|
| -#endif // defined(OS_WIN)
|
| -
|
| - // Renders page contents from |frame| to |content_area| of |canvas|.
|
| - // |page_number| is zero-based.
|
| - // When method is called, canvas should be setup to draw to |canvas_area|
|
| - // with |scale_factor|.
|
| - static float RenderPageContent(WebKit::WebFrame* frame,
|
| - int page_number,
|
| - const gfx::Rect& canvas_area,
|
| - const gfx::Rect& content_area,
|
| - double scale_factor,
|
| - WebKit::WebCanvas* canvas);
|
| -
|
| - // Helper methods -----------------------------------------------------------
|
| -
|
| - bool CopyAndPrint(WebKit::WebFrame* web_frame);
|
| -
|
| - bool CopyMetafileDataToSharedMem(Metafile* metafile,
|
| - base::SharedMemoryHandle* shared_mem_handle);
|
| -
|
| - // Helper method to get page layout in points and fit to page if needed.
|
| - static void ComputePageLayoutInPointsForCss(
|
| - WebKit::WebFrame* frame,
|
| - int page_index,
|
| - const PrintMsg_Print_Params& default_params,
|
| - bool ignore_css_margins,
|
| - double* scale_factor,
|
| - PageSizeMargins* page_layout_in_points);
|
| -
|
| - // Prepare the frame and view for print and then call this function to honor
|
| - // the CSS page layout information.
|
| - static void UpdateFrameAndViewFromCssPageLayout(
|
| - WebKit::WebFrame* frame,
|
| - const WebKit::WebNode& node,
|
| - PrepareFrameAndViewForPrint* prepare,
|
| - const PrintMsg_Print_Params& params,
|
| - bool ignore_css_margins);
|
| -
|
| - // Given the |device| and |canvas| to draw on, prints the appropriate headers
|
| - // and footers using strings from |header_footer_info| on to the canvas.
|
| - static void PrintHeaderAndFooter(
|
| - WebKit::WebCanvas* canvas,
|
| - int page_number,
|
| - int total_pages,
|
| - float webkit_scale_factor,
|
| - const PageSizeMargins& page_layout_in_points,
|
| - const base::DictionaryValue& header_footer_info,
|
| - const PrintMsg_Print_Params& params);
|
| -
|
| - bool GetPrintFrame(WebKit::WebFrame** frame);
|
| -
|
| - // This reports the current time - |start_time| as the time to render a page.
|
| - void ReportPreviewPageRenderTime(base::TimeTicks start_time);
|
| -
|
| - // Script Initiated Printing ------------------------------------------------
|
| -
|
| - // Return true if script initiated printing is currently
|
| - // allowed. |user_initiated| should be true when a user event triggered the
|
| - // script, most likely by pressing a print button on the page.
|
| - bool IsScriptInitiatedPrintAllowed(WebKit::WebFrame* frame,
|
| - bool user_initiated);
|
| -
|
| - // Returns true if script initiated printing occurs too often.
|
| - bool IsScriptInitiatedPrintTooFrequent(WebKit::WebFrame* frame);
|
| -
|
| - // Reset the counter for script initiated printing.
|
| - // Scripted printing will be allowed to continue.
|
| - void ResetScriptedPrintCount();
|
| -
|
| - // Increment the counter for script initiated printing.
|
| - // Scripted printing will be blocked for a limited amount of time.
|
| - void IncrementScriptedPrintCount();
|
| -
|
| - void RequestPrintPreview(PrintPreviewRequestType type);
|
| -
|
| - // Checks whether print preview should continue or not.
|
| - // Returns true if cancelling, false if continuing.
|
| - bool CheckForCancel();
|
| -
|
| - // Notifies the browser a print preview page has been rendered.
|
| - // |page_number| is 0-based.
|
| - // For a valid |page_number| with modifiable content,
|
| - // |metafile| is the rendered page. Otherwise |metafile| is NULL.
|
| - // Returns true if print preview should continue, false on failure.
|
| - bool PreviewPageRendered(int page_number, Metafile* metafile);
|
| -
|
| - // WebView used only to print the selection.
|
| - WebKit::WebView* print_web_view_;
|
| -
|
| - scoped_ptr<PrintMsg_PrintPages_Params> print_pages_params_;
|
| - bool is_preview_enabled_;
|
| - bool is_scripted_print_throttling_disabled_;
|
| - bool is_print_ready_metafile_sent_;
|
| - bool ignore_css_margins_;
|
| -
|
| - // Used for scripted initiated printing blocking.
|
| - base::Time last_cancelled_script_print_;
|
| - int user_cancelled_scripted_print_count_;
|
| - bool is_scripted_printing_blocked_;
|
| -
|
| - // Let the browser process know of a printing failure. Only set to false when
|
| - // the failure came from the browser in the first place.
|
| - bool notify_browser_of_print_failure_;
|
| -
|
| - // True, when printing from print preview.
|
| - bool print_for_preview_;
|
| -
|
| - scoped_ptr<PrintMsg_PrintPages_Params> old_print_pages_params_;
|
| -
|
| - // Strings generated by the browser process to be printed as headers and
|
| - // footers if requested by the user.
|
| - scoped_ptr<base::DictionaryValue> header_footer_info_;
|
| -
|
| - // Keeps track of the state of print preview between messages.
|
| - class PrintPreviewContext {
|
| - public:
|
| - PrintPreviewContext();
|
| - ~PrintPreviewContext();
|
| -
|
| - // 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);
|
| -
|
| - // 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 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;
|
| - 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_;
|
| -
|
| - 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_
|
| +// 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"
|
| +#include "base/memory/scoped_ptr.h"
|
| +#include "base/shared_memory.h"
|
| +#include "base/time.h"
|
| +#include "content/public/renderer/render_view_observer.h"
|
| +#include "content/public/renderer/render_view_observer_tracker.h"
|
| +#include "printing/metafile_impl.h"
|
| +#include "third_party/WebKit/Source/Platform/chromium/public/WebCanvas.h"
|
| +#include "third_party/WebKit/Source/WebKit/chromium/public/WebFrameClient.h"
|
| +#include "third_party/WebKit/Source/WebKit/chromium/public/WebNode.h"
|
| +#include "third_party/WebKit/Source/WebKit/chromium/public/WebPrintParams.h"
|
| +#include "third_party/WebKit/Source/WebKit/chromium/public/WebViewClient.h"
|
| +#include "ui/gfx/size.h"
|
| +
|
| +struct PrintMsg_Print_Params;
|
| +struct PrintMsg_PrintPage_Params;
|
| +struct PrintMsg_PrintPages_Params;
|
| +
|
| +namespace base {
|
| +class DictionaryValue;
|
| +}
|
| +
|
| +namespace WebKit {
|
| +class WebFrame;
|
| +class WebView;
|
| +}
|
| +
|
| +namespace printing {
|
| +
|
| +struct PageSizeMargins;
|
| +class PrepareFrameAndViewForPrint;
|
| +
|
| +// PrintWebViewHelper handles most of the printing grunt work for RenderView.
|
| +// We plan on making print asynchronous and that will require copying the DOM
|
| +// of the document and creating a new WebView with the contents.
|
| +class PrintWebViewHelper
|
| + : public content::RenderViewObserver,
|
| + public content::RenderViewObserverTracker<PrintWebViewHelper>,
|
| + public WebKit::WebViewClient,
|
| + public WebKit::WebFrameClient {
|
| + public:
|
| + explicit PrintWebViewHelper(content::RenderView* render_view);
|
| + virtual ~PrintWebViewHelper();
|
| +
|
| + void PrintNode(const WebKit::WebNode& node);
|
| +
|
| + protected:
|
| + // WebKit::WebViewClient override:
|
| + virtual void didStopLoading();
|
| +
|
| + private:
|
| + friend class PrintWebViewHelperTestBase;
|
| + FRIEND_TEST_ALL_PREFIXES(PrintWebViewHelperTest,
|
| + BlockScriptInitiatedPrinting);
|
| + FRIEND_TEST_ALL_PREFIXES(PrintWebViewHelperTest,
|
| + BlockScriptInitiatedPrintingFromPopup);
|
| + FRIEND_TEST_ALL_PREFIXES(PrintWebViewHelperTest, OnPrintPages);
|
| +
|
| +#if defined(OS_WIN) || defined(OS_MACOSX)
|
| + FRIEND_TEST_ALL_PREFIXES(PrintWebViewHelperTest, PrintLayoutTest);
|
| + FRIEND_TEST_ALL_PREFIXES(PrintWebViewHelperTest, PrintWithIframe);
|
| +#endif // defined(OS_WIN) || defined(OS_MACOSX)
|
| +
|
| + enum PrintingResult {
|
| + OK,
|
| + FAIL_PRINT_INIT,
|
| + FAIL_PRINT,
|
| + FAIL_PREVIEW,
|
| + };
|
| +
|
| + enum PrintPreviewErrorBuckets {
|
| + PREVIEW_ERROR_NONE, // Always first.
|
| + PREVIEW_ERROR_BAD_SETTING,
|
| + PREVIEW_ERROR_METAFILE_COPY_FAILED,
|
| + PREVIEW_ERROR_METAFILE_INIT_FAILED,
|
| + PREVIEW_ERROR_ZERO_PAGES,
|
| + PREVIEW_ERROR_MAC_DRAFT_METAFILE_INIT_FAILED,
|
| + PREVIEW_ERROR_PAGE_RENDERED_WITHOUT_METAFILE,
|
| + PREVIEW_ERROR_UPDATING_PRINT_SETTINGS,
|
| + PREVIEW_ERROR_INVALID_PRINTER_SETTINGS,
|
| + PREVIEW_ERROR_LAST_ENUM // Always last.
|
| + };
|
| +
|
| + enum PrintPreviewRequestType {
|
| + PRINT_PREVIEW_USER_INITIATED_ENTIRE_FRAME,
|
| + PRINT_PREVIEW_USER_INITIATED_CONTEXT_NODE,
|
| + PRINT_PREVIEW_SCRIPTED // triggered by window.print().
|
| + };
|
| +
|
| + // RenderViewObserver implementation.
|
| + virtual bool OnMessageReceived(const IPC::Message& message) OVERRIDE;
|
| + virtual void PrintPage(WebKit::WebFrame* frame, bool user_initiated) OVERRIDE;
|
| +
|
| + // Message handlers ---------------------------------------------------------
|
| +
|
| + // Print the document.
|
| + void OnPrintPages();
|
| +
|
| + // Print the document with the print preview frame/node.
|
| + void OnPrintForSystemDialog();
|
| +
|
| + // Get |page_size| and |content_area| information from
|
| + // |page_layout_in_points|.
|
| + void GetPageSizeAndContentAreaFromPageLayout(
|
| + const PageSizeMargins& page_layout_in_points,
|
| + gfx::Size* page_size,
|
| + gfx::Rect* content_area);
|
| +
|
| + // Update |ignore_css_margins_| based on settings.
|
| + void UpdateFrameMarginsCssInfo(const base::DictionaryValue& settings);
|
| +
|
| + // Returns true if the current destination printer is PRINT_TO_PDF.
|
| + bool IsPrintToPdfRequested(const base::DictionaryValue& settings);
|
| +
|
| + // Returns the print scaling option to retain/scale/crop the source page size
|
| + // to fit the printable area of the paper.
|
| + //
|
| + // We retain the source page size when the current destination printer is
|
| + // SAVE_AS_PDF.
|
| + //
|
| + // We crop the source page size to fit the printable area or we print only the
|
| + // left top page contents when
|
| + // (1) Source is PDF and the user has requested not to fit to printable area
|
| + // via |job_settings|.
|
| + // (2) Source is PDF. This is the first preview request and print scaling
|
| + // option is disabled for initiator renderer plugin.
|
| + //
|
| + // In all other cases, we scale the source page to fit the printable area.
|
| + WebKit::WebPrintScalingOption GetPrintScalingOption(
|
| + 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);
|
| +
|
| + // 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();
|
| +
|
| + // Print / preview the node under the context menu.
|
| + void OnPrintNodeUnderContextMenu();
|
| +
|
| + // Print the pages for print preview. Do not display the native print dialog
|
| + // for user settings. |job_settings| has new print job settings values.
|
| + void OnPrintForPrintPreview(const base::DictionaryValue& job_settings);
|
| +
|
| + void OnPrintingDone(bool success);
|
| +
|
| + // Enable/Disable window.print calls. If |blocked| is true window.print
|
| + // calls will silently fail. Call with |blocked| set to false to reenable.
|
| + void SetScriptedPrintBlocked(bool blocked);
|
| +
|
| + // Main printing code -------------------------------------------------------
|
| +
|
| + void Print(WebKit::WebFrame* frame, const WebKit::WebNode& node);
|
| +
|
| + // Notification when printing is done - signal tear-down/free resources.
|
| + void DidFinishPrinting(PrintingResult result);
|
| +
|
| + // Print Settings -----------------------------------------------------------
|
| +
|
| + // Initialize print page settings with default settings.
|
| + // Used only for native printing workflow.
|
| + bool InitPrintSettings(bool fit_to_paper_size);
|
| +
|
| + // Calculate number of pages in source document.
|
| + bool CalculateNumberOfPages(WebKit::WebFrame* frame,
|
| + const WebKit::WebNode& node,
|
| + int* number_of_pages);
|
| +
|
| + // Update the current print settings with new |passed_job_settings|.
|
| + // |passed_job_settings| dictionary contains print job details such as printer
|
| + // name, number of copies, page range, etc.
|
| + bool UpdatePrintSettings(WebKit::WebFrame* frame,
|
| + const WebKit::WebNode& node,
|
| + const base::DictionaryValue& passed_job_settings);
|
| +
|
| + // Get final print settings from the user.
|
| + // Return false if the user cancels or on error.
|
| + bool GetPrintSettingsFromUser(WebKit::WebFrame* frame,
|
| + const WebKit::WebNode& node,
|
| + int expected_pages_count);
|
| +
|
| + // Page Printing / Rendering ------------------------------------------------
|
| +
|
| + // Prints all the pages listed in |print_pages_params_|.
|
| + // It will implicitly revert the document to display CSS media type.
|
| + bool PrintPages(WebKit::WebFrame* frame, const WebKit::WebNode& node);
|
| + bool PrintPagesNative(WebKit::WebFrame* frame,
|
| + const WebKit::WebNode& node,
|
| + int page_count,
|
| + const gfx::Size& canvas_size);
|
| +
|
| + // Prints the page listed in |params|.
|
| +#if defined(USE_X11)
|
| + void PrintPageInternal(const PrintMsg_PrintPage_Params& params,
|
| + const gfx::Size& canvas_size,
|
| + WebKit::WebFrame* frame,
|
| + Metafile* metafile);
|
| +#else
|
| + void PrintPageInternal(const PrintMsg_PrintPage_Params& params,
|
| + const gfx::Size& canvas_size,
|
| + WebKit::WebFrame* frame);
|
| +#endif
|
| +
|
| + // Render the frame for printing.
|
| + bool RenderPagesForPrint(WebKit::WebFrame* frame,
|
| + const WebKit::WebNode& node);
|
| +
|
| + // Platform specific helper function for rendering page(s) to |metafile|.
|
| +#if defined(OS_WIN)
|
| + void RenderPage(const PrintMsg_Print_Params& params,
|
| + int page_number,
|
| + WebKit::WebFrame* frame,
|
| + bool is_preview,
|
| + Metafile* metafile,
|
| + double* scale_factor,
|
| + gfx::Size* page_size_in_dpi,
|
| + gfx::Rect* content_area_in_dpi);
|
| +#elif defined(OS_MACOSX)
|
| + void RenderPage(const PrintMsg_Print_Params& params,
|
| + int page_number,
|
| + WebKit::WebFrame* frame,
|
| + bool is_preview,
|
| + Metafile* metafile,
|
| + gfx::Size* page_size,
|
| + gfx::Rect* content_rect);
|
| +#elif defined(OS_POSIX)
|
| + bool RenderPages(const PrintMsg_PrintPages_Params& params,
|
| + WebKit::WebFrame* frame,
|
| + std::vector<int>* printed_pages,
|
| + int page_count,
|
| + const gfx::Size& canvas_size,
|
| + Metafile* metafile);
|
| +#endif // defined(OS_WIN)
|
| +
|
| + // Renders page contents from |frame| to |content_area| of |canvas|.
|
| + // |page_number| is zero-based.
|
| + // When method is called, canvas should be setup to draw to |canvas_area|
|
| + // with |scale_factor|.
|
| + static float RenderPageContent(WebKit::WebFrame* frame,
|
| + int page_number,
|
| + const gfx::Rect& canvas_area,
|
| + const gfx::Rect& content_area,
|
| + double scale_factor,
|
| + WebKit::WebCanvas* canvas);
|
| +
|
| + // Helper methods -----------------------------------------------------------
|
| +
|
| + bool CopyAndPrint(WebKit::WebFrame* web_frame);
|
| +
|
| + bool CopyMetafileDataToSharedMem(Metafile* metafile,
|
| + base::SharedMemoryHandle* shared_mem_handle);
|
| +
|
| + // Helper method to get page layout in points and fit to page if needed.
|
| + static void ComputePageLayoutInPointsForCss(
|
| + WebKit::WebFrame* frame,
|
| + int page_index,
|
| + const PrintMsg_Print_Params& default_params,
|
| + bool ignore_css_margins,
|
| + double* scale_factor,
|
| + PageSizeMargins* page_layout_in_points);
|
| +
|
| + // Given the |device| and |canvas| to draw on, prints the appropriate headers
|
| + // and footers using strings from |header_footer_info| on to the canvas.
|
| + static void PrintHeaderAndFooter(
|
| + WebKit::WebCanvas* canvas,
|
| + int page_number,
|
| + int total_pages,
|
| + float webkit_scale_factor,
|
| + const PageSizeMargins& page_layout_in_points,
|
| + const base::DictionaryValue& header_footer_info,
|
| + const PrintMsg_Print_Params& params);
|
| +
|
| + bool GetPrintFrame(WebKit::WebFrame** frame);
|
| +
|
| + // This reports the current time - |start_time| as the time to render a page.
|
| + void ReportPreviewPageRenderTime(base::TimeTicks start_time);
|
| +
|
| + // Script Initiated Printing ------------------------------------------------
|
| +
|
| + // Return true if script initiated printing is currently
|
| + // allowed. |user_initiated| should be true when a user event triggered the
|
| + // script, most likely by pressing a print button on the page.
|
| + bool IsScriptInitiatedPrintAllowed(WebKit::WebFrame* frame,
|
| + bool user_initiated);
|
| +
|
| + // Returns true if script initiated printing occurs too often.
|
| + bool IsScriptInitiatedPrintTooFrequent(WebKit::WebFrame* frame);
|
| +
|
| + // Reset the counter for script initiated printing.
|
| + // Scripted printing will be allowed to continue.
|
| + void ResetScriptedPrintCount();
|
| +
|
| + // Increment the counter for script initiated printing.
|
| + // Scripted printing will be blocked for a limited amount of time.
|
| + void IncrementScriptedPrintCount();
|
| +
|
| + void RequestPrintPreview(PrintPreviewRequestType type);
|
| +
|
| + // Checks whether print preview should continue or not.
|
| + // Returns true if cancelling, false if continuing.
|
| + bool CheckForCancel();
|
| +
|
| + // Notifies the browser a print preview page has been rendered.
|
| + // |page_number| is 0-based.
|
| + // For a valid |page_number| with modifiable content,
|
| + // |metafile| is the rendered page. Otherwise |metafile| is NULL.
|
| + // Returns true if print preview should continue, false on failure.
|
| + bool PreviewPageRendered(int page_number, Metafile* metafile);
|
| +
|
| + // WebView used only to print the selection.
|
| + WebKit::WebView* print_web_view_;
|
| +
|
| + scoped_ptr<PrintMsg_PrintPages_Params> print_pages_params_;
|
| + bool is_preview_enabled_;
|
| + bool is_scripted_print_throttling_disabled_;
|
| + bool is_print_ready_metafile_sent_;
|
| + bool ignore_css_margins_;
|
| +
|
| + // Used for scripted initiated printing blocking.
|
| + base::Time last_cancelled_script_print_;
|
| + int user_cancelled_scripted_print_count_;
|
| + bool is_scripted_printing_blocked_;
|
| +
|
| + // Let the browser process know of a printing failure. Only set to false when
|
| + // the failure came from the browser in the first place.
|
| + bool notify_browser_of_print_failure_;
|
| +
|
| + // True, when printing from print preview.
|
| + bool print_for_preview_;
|
| +
|
| + scoped_ptr<PrintMsg_PrintPages_Params> old_print_pages_params_;
|
| +
|
| + // Strings generated by the browser process to be printed as headers and
|
| + // footers if requested by the user.
|
| + scoped_ptr<base::DictionaryValue> header_footer_info_;
|
| +
|
| + // Keeps track of the state of print preview between messages.
|
| + class PrintPreviewContext {
|
| + public:
|
| + PrintPreviewContext();
|
| + ~PrintPreviewContext();
|
| +
|
| + // 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);
|
| +
|
| + // 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 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;
|
| + 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_;
|
| +
|
| + 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_
|
|
|