Merge 173933

ui/aura/root_window_host.h

 // Copyright (c) 2012 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 UI_AURA_ROOT_WINDOW_HOST_H_
 #define UI_AURA_ROOT_WINDOW_HOST_H_
 
 #include <vector>
 
 #include "base/message_loop.h"
@@ skipping 57 matching lines @@
 
   // Releases OS capture of the root window.
   virtual void ReleaseCapture() = 0;
 
   // Sets the currently displayed cursor.
   virtual void SetCursor(gfx::NativeCursor cursor) = 0;
 
   // Queries the mouse's current position relative to the host window and sets
   // it in |location_return|. Returns true if the cursor is within the host
   // window. The position set to |location_return| is constrained within the
-  // host window.
+  // host window. If the cursor is disabled, returns false and (0, 0) is set to
+  // |location_return|.
   // This method is expensive, instead use gfx::Screen::GetCursorScreenPoint().
   virtual bool QueryMouseLocation(gfx::Point* location_return) = 0;
 
   // Clips the cursor to the bounds of the root window until UnConfineCursor().
   virtual bool ConfineCursorToRootWindow() = 0;
   virtual void UnConfineCursor() = 0;
 
   // Called when the cursor visibility has changed.
   virtual void OnCursorVisibilityChanged(bool show) = 0;
 
@@ skipping 24 matching lines @@
   // Called when the device scale factor of the root window has chagned.
   virtual void OnDeviceScaleFactorChanged(float device_scale_factor) = 0;
 
   // Stop listening events in preparation for shutdown.
   virtual void PrepareForShutdown() = 0;
 };
 
 }  // namespace aura
 
 #endif  // UI_AURA_ROOT_WINDOW_HOST_H_