printing/print_dialog_gtk_interface.h

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef PRINTING_PRINT_DIALOG_GTK_INTERFACE_H_
   6 #define PRINTING_PRINT_DIALOG_GTK_INTERFACE_H_
   7
   8 #include "base/string16.h"
   9 #include "printing/printing_context_gtk.h"
  10
  11 namespace printing {
  12
  13 class Metafile;
  14 class PrintSettings;
  15
  16 // An interface for GTK printing dialogs. Classes that live outside of
  17 // printing/ can implement this interface and get threading requirements
  18 // correct without exposing those requirements to printing/.
  19 class PrintDialogGtkInterface {
  20  public:
  21   // Tell the dialog to use the default print setting.
  22   virtual void UseDefaultSettings() = 0;
  23
  24   // Update the dialog to use |job_settings| and |ranges|, where |job_settings|
  25   // is a dictionary of settings with possible keys from
  26   // printing/print_job_constants.h. Only used when printing without the system
  27   // print dialog. E.g. for Print Preview. Returns false on error.
  28   virtual bool UpdateSettings(const base::DictionaryValue& job_settings,
  29                               const PageRanges& ranges,
  30                               PrintSettings* settings) = 0;
  31
  32   // Shows the dialog and handles the response with |callback|. Only used when
  33   // printing with the native print dialog.
  34   virtual void ShowDialog(
  35       bool has_selection,
  36       const PrintingContextGtk::PrintSettingsCallback& callback) = 0;
  37
  38   // Prints the document named |document_name| contained in |metafile|.
  39   // Called from the print worker thread. Once called, the
  40   // PrintDialogGtkInterface instance should not be reused.
  41   virtual void PrintDocument(const Metafile* metafile,
  42                              const string16& document_name) = 0;
  43
  44   // Same as AddRef/Release, but with different names since
  45   // PrintDialogGtkInterface does not inherit from RefCounted.
  46   virtual void AddRefToDialog() = 0;
  47   virtual void ReleaseDialog() = 0;
  48
  49  protected:
  50   virtual ~PrintDialogGtkInterface() {}
  51 };
  52
  53 }  // namespace printing
  54
  55 #endif  // PRINTING_PRINT_DIALOG_GTK_INTERFACE_H_