components/web_modal/popup_manager.h

   1 // Copyright 2014 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 COMPONENTS_WEB_MODAL_POPUP_MANAGER_H_
   6 #define COMPONENTS_WEB_MODAL_POPUP_MANAGER_H_
   7
   8 #include "base/memory/scoped_ptr.h"
   9 #include "base/memory/weak_ptr.h"
  10 #include "ui/gfx/native_widget_types.h"
  11
  12 namespace content {
  13 class WebContents;
  14 }
  15
  16 namespace gfx {
  17 class Size;
  18 }
  19
  20 namespace web_modal {
  21
  22 class WebContentsModalDialogHost;
  23
  24 // Per-Browser class to manage popups (bubbles, web-modal dialogs).
  25 class PopupManager {
  26  public:
  27   // |host| may be null.
  28   explicit PopupManager(WebContentsModalDialogHost* host);
  29
  30   ~PopupManager();
  31
  32   // Returns the native view which will be the parent of managed popups.
  33   gfx::NativeView GetHostView() const;
  34
  35   // Temporary method: Provides compatibility with existing
  36   // WebContentsModalDialogManager code.
  37   void ShowModalDialog(gfx::NativeWindow popup,
  38                        content::WebContents* web_contents);
  39
  40   // Returns true if a web modal dialog is active and not closed in the
  41   // given |web_contents|. Note: this is intended for legacy use only; it will
  42   // be deleted at some point -- new code shouldn't use it.
  43   bool IsWebModalDialogActive(const content::WebContents* web_contents) const;
  44
  45   // Called when a native popup we own is about to be closed.
  46   void WillClose(gfx::NativeWindow popup);
  47
  48   // Called by views code to re-activate popups anchored to a particular tab
  49   // when that tab gets focus. Note that depending on the situation, more than
  50   // one popup may actually be shown (depending on overlappability). The
  51   // semantics are that the popups that would have been displayed had the tab
  52   // never lost focus are re-focused when tab focus is regained.
  53   void WasFocused(const content::WebContents* web_contents);
  54
  55   // WebContentsUserData-alike API for retrieving the associated window
  56   // PopupManager from a |web_contents|. Any window which doesn't have a popup
  57   // manager associated will return null -- popups should not be issued against
  58   // that window.
  59   static PopupManager* FromWebContents(content::WebContents* web_contents);
  60
  61   // Should not be called except by WebContents-owning class; not by clients.
  62   void RegisterWith(content::WebContents* web_contents);
  63   void UnregisterWith(content::WebContents* web_contents);
  64
  65   // DEPRECATED.
  66   void CloseAllDialogsForTesting(content::WebContents* web_contents);
  67
  68  private:
  69   WebContentsModalDialogHost* host_;
  70
  71   base::WeakPtrFactory<PopupManager> weak_factory_;
  72
  73   DISALLOW_COPY_AND_ASSIGN(PopupManager);
  74 };
  75
  76 }  // namespace web_modal
  77
  78 #endif  // COMPONENTS_WEB_MODAL_POPUP_MANAGER_H_