mus: Let clients set the cursor of their window.

components/mus/public/interfaces/window_tree.mojom

 // Copyright 2014 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.
 
 module mus.mojom;
 
 import "components/mus/public/interfaces/compositor_frame.mojom";
+import "components/mus/public/interfaces/cursor.mojom";
 import "components/mus/public/interfaces/input_events.mojom";
 import "components/mus/public/interfaces/mus_constants.mojom";
 import "components/mus/public/interfaces/surface_id.mojom";
 import "components/mus/public/interfaces/window_manager_constants.mojom";
 import "ui/mojo/geometry/geometry.mojom";
 import "ui/mojo/ime/text_input_state.mojom";
 
 struct ViewportMetrics {
   mojo.Size size_in_pixels;
   // A value of 0 indicates the real value is not yet available.
@@ skipping 179 matching lines @@
   //
   // policy_bitmask is a bitmask of the kAccessPolicy constants. See them for
   // details.
   Embed(uint32 window_id,
         WindowTreeClient client,
         uint32 policy_bitmask) => (bool success, uint16 connection_id);
 
   SetFocus(uint32 window_id);
   SetCanFocus(uint32 window_id, bool can_focus);
 
+  // Sets the cursor when the pointer is inside |window_id| to a system standard
+  // cursor provided by the window manager.
+  SetStandardCursor(uint32 window_id, Cursor cursor_id);

[sky, 2015/12/01 21:48:00]

Make this take a change_id, like SetWindowProperty does. See how
SetWindowProperty deals with this for how to handle it.

I was a bit thrown by the name, did you consider 'predefined', as that is what
it is?

[Elliot Glaysher, 2015/12/02 20:01:31]

Done.

+
+  // TODO(erg): Additional cursor methods. Image based cursors, visibility,
+  // and cursor locking.
+
   // Set text input state for the given window.
   SetWindowTextInputState(uint32 window_id, mojo.TextInputState state);
 
   // Set the input method editor UI (software keyboard, etc) visibility.
   // If state is non-null, the specified window's text input state is updated.
   // Otherwise the existing state is used.
   SetImeVisibility(uint32 window_id, bool visible, mojo.TextInputState? state);
 
   // See documentation for WindowTreeClient::OnWindowInputEvent().
   OnWindowInputEventAck(uint32 event_id);
@@ skipping 92 matching lines @@
                                 array<uint8>? new_data);
 
   // Invoked when an event is targeted at the specified window. The client must
   // call WindowTree::OnWindowInputEventAck() with the same |event_id| to notify
   // that the event has been processed. The client will not receive farther
   // events until the event is ack'ed.
   OnWindowInputEvent(uint32 event_id, uint32 window, Event event);
 
   OnWindowFocused(uint32 focused_window_id);
 
+  OnWindowCursorChanged(uint32 window_id, Cursor cursor_id);
+
   // A change initiated from the client has completed. See description of
   // change ids for details.
   OnChangeCompleted(uint32 change_id, bool success);
 
   // --------------------------------------------------------------------------
   // This section is for functions that are expected to be pulled into the
   // WindowManager interface once we get associated interfaces.
 
   // Calls to SetWindowBounds() for windows owned by the window manager end up
   // here. The window manager should reply with WmResponse() as appropriate.
   WmSetBounds(uint32 change_id, uint32 window_id, mojo.Rect bounds);
   WmSetProperty(uint32 change_id,
                 uint32 window_id,
                 string name,
                 array<uint8>? value);
 };