Add chrome to the repository.

git-svn-id: svn://svn.chromium.org/chrome/trunk/src@15 0039d316-1c4b-4281-b951-d872f2087c98

1 files changed, 192 insertions, 0 deletions

diff --git a/chrome/browser/printing/print_view_manager.h b/chrome/browser/printing/print_view_manager.h
new file mode 100644
index 0000000..b0a154e
--- /dev/null
+++ b/chrome/browser/printing/print_view_manager.h
@@ -0,0 +1,192 @@
+// Copyright 2008, Google Inc.
+// All rights reserved.
+//
+// Redistribution and use in source and binary forms, with or without
+// modification, are permitted provided that the following conditions are
+// met:
+//
+//    * Redistributions of source code must retain the above copyright
+// notice, this list of conditions and the following disclaimer.
+//    * Redistributions in binary form must reproduce the above
+// copyright notice, this list of conditions and the following disclaimer
+// in the documentation and/or other materials provided with the
+// distribution.
+//    * Neither the name of Google Inc. nor the names of its
+// contributors may be used to endorse or promote products derived from
+// this software without specific prior written permission.
+//
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+#ifndef CHROME_BROWSER_PRINTING_PRINT_VIEW_MANAGER_H__
+#define CHROME_BROWSER_PRINTING_PRINT_VIEW_MANAGER_H__
+
+#include "chrome/browser/printing/printed_pages_source.h"
+#include "chrome/common/notification_service.h"
+#include "chrome/common/render_messages.h"
+
+class RenderViewHost;
+class WebContents;
+
+namespace printing {
+
+class JobEventDetails;
+class PrintJob;
+class PrintJobWorkerOwner;
+
+// Manages the print commands in relation to a WebContents. WebContents
+// delegates a few printing related commands to this instance.
+class PrintViewManager : public NotificationObserver,
+                         public PrintedPagesSource {
+ public:
+  PrintViewManager(WebContents& owner);
+
+  // Destroys the "Print..." dialog, makes sure the pages are finished rendering
+  // and release the print job.
+  void Destroy();
+
+  // Cancels the print job.
+  void Stop();
+
+  // Shows the "Print..." dialog if none is shown and if no rendering is
+  // pending. This is done asynchronously.
+  void ShowPrintDialog();
+
+  // Initiates a print job immediately. This is done asynchronously. Returns
+  // false if printing is impossible at the moment.
+  bool PrintNow();
+
+  // Terminates or cancels the print job if one was pending, depending on the
+  // current state. Returns false if the renderer was not valuable.
+  bool OnRendererGone(RenderViewHost* render_view_host);
+
+  // Received a notification from the renderer that the number of printed page
+  // has just been calculated..
+  void DidGetPrintedPagesCount(int cookie, int number_pages);
+
+  // Received a notification from the renderer that a printed page page is
+  // finished renderering.
+  void DidPrintPage(const ViewHostMsg_DidPrintPage_Params& params);
+
+  // PrintedPagesSource implementation.
+  virtual void RenderOnePrintedPage(PrintedDocument* document, int page_number);
+  virtual std::wstring RenderSourceName();
+  virtual GURL RenderSourceUrl();
+
+  // NotificationObserver implementation.
+  virtual void Observe(NotificationType type,
+                       const NotificationSource& source,
+                       const NotificationDetails& details);
+
+ private:
+  // Processes a NOTIFY_PRINT_JOB_EVENT notification.
+  void OnNotifyPrintJobEvent(const JobEventDetails& event_details);
+
+  // Processes a xxx_INIT_xxx type of NOTIFY_PRINT_JOB_EVENT notification.
+  void OnNotifyPrintJobInitEvent(const JobEventDetails& event_details);
+
+  // Requests the RenderView to render all the missing pages for the print job.
+  // Noop if no print job is pending. Returns true if at least one page has been
+  // requested to the renderer.
+  bool RenderAllMissingPagesNow();
+
+  // Quits the current message loop if these conditions hold true: a document is
+  // loaded and is complete and waiting_for_pages_to_be_rendered_ is true. This
+  // function is called in DidPrintPage() or on ALL_PAGES_REQUESTED
+  // notification. The inner message loop is created was created by
+  // RenderAllMissingPagesNow().
+  void ShouldQuitFromInnerMessageLoop();
+
+  // Creates a new empty print job. It has no settings loaded. If there is
+  // currently a print job, safely disconnect from it. Returns false if it is
+  // impossible to safely disconnect from the current print job or it is
+  // impossible to create a new print job.
+  bool CreateNewPrintJob(PrintJobWorkerOwner* job);
+
+  // Makes sure the current print_job_ has all its data before continuing, and
+  // disconnect from it.
+  void DisconnectFromCurrentPrintJob();
+
+  // Terminates the print job. Noop if no print job has been created. If
+  // |cancel| is true, cancel it instead of waiting for the job to finish. Will
+  // call ReleasePrintJob().
+  void TerminatePrintJob(bool cancel);
+
+  // Releases print_job_. Correctly deregisters from notifications. Noop if
+  // no print job has been created.
+  void ReleasePrintJob();
+
+  // Prints the document. Starts the actual print job. Requests asynchronously
+  // the renderered pages from the renderer. Is called once the printing context
+  // is initialized, on a DEFAULT_INIT_DONE notification when waiting_to_print_
+  // is true.
+  void PrintNowInternal();
+
+  // Runs an inner message loop. It will set inside_inner_message_loop_ to true
+  // while the blocking inner message loop is running. This is useful in cases
+  // where the RenderView is about to be destroyed while a printing job isn't
+  // finished.
+  bool RunInnerMessageLoop();
+
+  // In the case of Scripted Printing, where the renderer is controlling the
+  // control flow, print_job_ is initialized whenever possible. No-op is
+  // print_job_ is initialized.
+  bool OpportunisticallyCreatePrintJob(int cookie);
+
+  // Cache the last print settings requested to the renderer.
+  ViewMsg_Print_Params print_params_;
+
+  // Manages the low-level talk to the printer.
+  scoped_refptr<PrintJob> print_job_;
+
+  // Waiting for print_job_ initialization to be completed to start printing.
+  // Specifically the DEFAULT_INIT_DONE notification. Set when PrintNow() is
+  // called.
+  bool waiting_to_print_;
+
+  // Running an inner message loop inside RenderAllMissingPagesNow(). This means
+  // we are _blocking_ until all the necessary pages have been rendered or the
+  // print settings are being loaded.
+  bool inside_inner_message_loop_;
+
+  // The object is waiting for some information to call print_job_->Init(true).
+  // It is either a DEFAULT_INIT_DONE notification or the
+  // DidGetPrintedPagesCount() callback.
+  // Showing the Print... dialog box is a multi-step operation:
+  // - print_job_->Init(false) to get the default settings. Set
+  //   waiting_to_show_print_dialog_ = true.
+  // - on DEFAULT_INIT_DONE, gathers new settings.
+  // - did settings() or document() change since the last intialization?
+  //   - Call SwitchCssToPrintMediaType()
+  //     - On DidGetPrintedPagesCount() call, if
+  //       waiting_to_show_print_dialog_ = true
+  //       - calls print_job_->Init(true).
+  //       - waiting_to_show_print_dialog_ = false.
+  //       - DONE.
+  // - else (It may happens when redisplaying the dialog box with settings that
+  //         haven't changed)
+  //   - if waiting_to_show_print_dialog_ = true && page_count is initialized.
+  //     - calls print_job_->Init(true).
+  //     - waiting_to_show_print_dialog_ = false.
+  bool waiting_to_show_print_dialog_;
+
+  // PrintViewManager is created as an extension of WebContent specialized for
+  // printing-related behavior. Still, access to the renderer is needed so a
+  // back reference is kept the the "parent object".
+  WebContents& owner_;
+
+  DISALLOW_EVIL_CONSTRUCTORS(PrintViewManager);
+};
+
+}  // namespace printing
+
+#endif  // CHROME_BROWSER_PRINTING_PRINT_VIEW_MANAGER_H__