Update To 11.40.268.0

[platform/framework/web/crosswalk.git] / src / ui / views / widget / desktop_aura / desktop_capture_client.h

diff --git a/src/ui/views/widget/desktop_aura/desktop_capture_client.h b/src/ui/views/widget/desktop_aura/desktop_capture_client.h
index 5f8cecf..6c5ce7b 100644 (file)
--- a/src/ui/views/widget/desktop_aura/desktop_capture_client.h
+++ b/src/ui/views/widget/desktop_aura/desktop_capture_client.h
@@ -20,20 +20,33 @@ namespace views {
 
 // Desktop implementation of CaptureClient. There is one CaptureClient per
 // DesktopNativeWidgetAura.
+//
+// DesktopCaptureClient and CaptureController (used by ash) differ slightly in
+// how they handle capture. CaptureController is a singleton shared among all
+// RootWindows created by ash. An implication of this is that all RootWindows
+// know which window has capture. This is not the case with
+// DesktopCaptureClient. Instead each RootWindow has its own
+// DesktopCaptureClient. This means only the RootWindow of the Window that has
+// capture knows which window has capture. All others think no one has
+// capture. This behavior is necessitated by Windows occassionally delivering
+// mouse events to a window other than the capture window and expecting that
+// window to get the event. If we shared the capture window on the desktop this
+// behavior would not be possible.
 class VIEWS_EXPORT DesktopCaptureClient : public aura::client::CaptureClient {
  public:
-  explicit DesktopCaptureClient(aura::RootWindow* root);
-  virtual ~DesktopCaptureClient();
+  explicit DesktopCaptureClient(aura::Window* root);
+  ~DesktopCaptureClient() override;
 
   // Overridden from aura::client::CaptureClient:
-  virtual void SetCapture(aura::Window* window) OVERRIDE;
-  virtual void ReleaseCapture(aura::Window* window) OVERRIDE;
-  virtual aura::Window* GetCaptureWindow() OVERRIDE;
+  void SetCapture(aura::Window* window) override;
+  void ReleaseCapture(aura::Window* window) override;
+  aura::Window* GetCaptureWindow() override;
+  aura::Window* GetGlobalCaptureWindow() override;
 
  private:
   typedef std::set<DesktopCaptureClient*> CaptureClients;
 
-  aura::RootWindow* root_;
+  aura::Window* root_;
   aura::Window* capture_window_;
 
   // Set of DesktopCaptureClients.