Implement print preview tab controller.

chrome/browser/printing/print_preview_tab_controller.h

+// Copyright (c) 2010 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_BROWSER_PRINTING_PRINT_PREVIEW_TAB_CONTROLLER_H_
+#define CHROME_BROWSER_PRINTING_PRINT_PREVIEW_TAB_CONTROLLER_H_
+#pragma once
+
+#include <map>
+
+#include "base/ref_counted.h"
+#include "chrome/common/notification_observer.h"
+#include "chrome/common/notification_registrar.h"
+
+class Browser;
+class TabContents;
+
+namespace printing {
+
+// For print preview, a print preview (PP) tab should be linked with the
+// initiator tab that initiated the printing operation. If the tab initiates
+// a second printing operation while the first print preview tab is still open,
+// that PP tab should be focused/activated. There may be more than one PP tab
+// open. There is 1:1 relationship between PP tabs and initiating tabs. This
+// class manages PP tabs and initiator tabs.
+class PrintPreviewTabController
+  : public base::RefCounted<PrintPreviewTabController>,
+    public NotificationObserver {
+ public:
+  static PrintPreviewTabController* GetInstance();
+
+  PrintPreviewTabController();
+
+  virtual ~PrintPreviewTabController();
+
+  // Get/Create the print preview tab for initiator_tab.
+  // |browser_window_id| is used to identify |initiator_tab| browser window.
+  TabContents* GetOrCreatePreviewTab(
+      TabContents* initiator_tab, int browser_window_id);
+
+  // Notification observer implementation.
+  virtual void Observe(NotificationType type,
+                       const NotificationSource& source,
+                       const NotificationDetails& details);
+
+ private:
+  friend class base::RefCounted<PrintPreviewTabController>;
+
+  // Returns true if |tab| is a print preview tab.
+  bool IsPrintPreviewTab(TabContents* tab);

[Lei Zhang, 2010/11/13 05:04:56]

nit: Be consistent. Either name this IsPreviewTab() or change GetPreviewTab() to
GetPrintPreviewTab().

[kmadhusu, 2010/11/15 21:22:27]

Renamed IsPrintPreviewTab() to IsPreviewTab().

+
+  // Return the initiator tab for |preview_tab| or return NULL.
+  TabContents* GetInitiatorTab(TabContents* preview_tab);
+
+  // Return preview tab for |initiator_tab| or return NULL.
+  TabContents* GetPreviewTab(TabContents* initiator_tab);

[Lei Zhang, 2010/11/13 05:04:56]

nit: |initiator_tab| is called "current_tab" in the implementation. This should
be renamed because the tabs passed to this method are not always initiator tabs.
You should mention what happens when you pass in a preview tab.

[kmadhusu, 2010/11/15 21:22:27]

Done.

+
+  // Create a new print preview tab.
+  TabContents* CreatePrintPreviewTab(
+      TabContents* initiator_tab, int browser_window_id);
+
+  // Add/Remove observers for notifications from |tab|.
+  void AddObservers(TabContents* tab);
+  void RemoveObservers(TabContents* tab);
+
+  // 1:1 relationship between initiator tab and print preview tab.
+  // Key: Preview tab.
+  // Value: Initiator tab.
+  typedef std::map<TabContents*, TabContents*> PrintPreviewTabMap;
+  PrintPreviewTabMap preview_tab_map_;
+
+  // A registrar for listening for TAB_CONTENTS_DESTROYED notification.
+  NotificationRegistrar registrar_;
+
+  // Are we waiting for a new preview tab with NavigationType::NEW_PAGE? If so,
+  // do nothing in observer.
+  bool waiting_for_new_preview_page_;
+
+  DISALLOW_COPY_AND_ASSIGN(PrintPreviewTabController);
+};
+
+}  // namespace printing
+#endif  // CHROME_BROWSER_PRINTING_PRINT_PREVIEW_TAB_CONTROLLER_H_