Rename ViewManagerService,ViewManagerClient -> ViewTree,ViewTreeClient

components/view_manager/public/interfaces/view_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 mojo;
 
 import "components/view_manager/public/interfaces/surface_id.mojom";
 import "components/view_manager/public/interfaces/view_manager_constants.mojom";
 import "mojo/application/public/interfaces/service_provider.mojom";
 import "network/public/interfaces/url_loader.mojom";
@@ skipping 24 matching lines @@
 enum ErrorCode {
   NONE,
   VALUE_IN_USE,
   ILLEGAL_ARGUMENT,
 };
 
 // Views are identified by a uint32. The upper 16 bits are the connection id,
 // and the lower 16 the id assigned by the client.
 //
 // The root view is identified with a connection id of 0, and value of 1.
-interface ViewManagerService {
+interface ViewTree {
   // Creates a new view with the specified id. It is up to the client to ensure
   // the id is unique to the connection (the id need not be globally unique).
   // Additionally the connection id (embedded in |view_id|) must match that of
   // the connection.
   // Errors:
   //   ERROR_CODE_VALUE_IN_USE: a view already exists with the specified id.
   //   ERROR_CODE_ILLEGAL_ARGUMENT: The connection part of |view_id| does not
   //     match the connection id of the client.
   //
   // TODO(erg): Once we have default values in mojo, make this take a map of
@@ skipping 49 matching lines @@
 
   // Returns the views comprising the tree starting at |view_id|. |view_id| is
   // the first result in the return value, unless |view_id| is invalid, in which
   // case an empty vector is returned. The views are visited using a depth first
   // search (pre-order).
   GetViewTree(uint32 view_id) => (array<ViewData> views);
 
   // Shows the surface in the specified view.
   SetViewSurfaceId(uint32 view_id, SurfaceId surface_id) => (bool success);
 
-  // Tells the ViewManagerService that the ViewManagerClient wants to get
+  // Tells the ViewTree that the ViewTreeClient wants to get
   // OnEmbedForDescendant() when EmbedAllowingReembed() is invoked on any
   // descendant Views.
   //
   // See Embed() docs for more details.
   //
   // TODO(sky): this needs to be restricted in some way. Maybe the root can
   // grant this ability?
   SetEmbedRoot();
 
   // A connection may grant access to a view from another connection by way of
   // the embed functions. The following variants exist:
   //
-  // . Embed: the client supplies the ViewManagerClient to embed.
+  // . Embed: the client supplies the ViewTreeClient to embed.
   // . EmbedAllowingReembed: walks the view tree for the first embed root
   //   ancestor and asks it to perform the embed (OnEmbedForDescendant()).
   //   The embed root ancestor may allow or disallow the request. If there is no
   //   embed root ancestor ViewManager connects to the application and requests
-  //   a ViewManagerClient from it.
+  //   a ViewTreeClient from it.
   //
-  // In all cases the new ViewManagerClient is configured with a root of
-  // |view_id|.
+  // In all cases the new ViewTreeClient is configured with a root of |view_id|.
   //
   // The caller must have created |view_id|. If not the request fails and the
   // response is false.
   //
   // A view may only have one embedding in it at a time. Subsequent calls to
   // Embed() for the same view result in the currently embedded
-  // ViewManagerClient being removed. The embedded app is told this by way of
+  // ViewTreeClient being removed. The embedded app is told this by way of
   // OnUnembed(), which is followed by OnViewDeleted() (as the connection no
   // longer has access to the view).
   //
   // The embedder can detect when the embedded app disconnects by way of
   // OnEmbeddedAppDisconnected().
   //
   // When a connection embeds an app the connection no longer has privileges
   // to access or see any of the children of the view. If the view had existing
   // children the children are removed. The one exception is the root
   // connection and any embed roots. The root always see the full tree, and
   // embed roots see the complete tree at their embed point.
-  Embed(uint32 view_id, ViewManagerClient client) => (bool success);
+  Embed(uint32 view_id, ViewTreeClient client) => (bool success);
   EmbedAllowingReembed(uint32 view_id, URLRequest request) => (bool success);
 
   SetFocus(uint32 view_id) => (bool success);
 
   // Set text input state for the given view.
   SetViewTextInputState(uint32 view_id, TextInputState state);
 
   // Set the input method editor UI (software keyboard, etc) visibility.
   // If state is non-null, the specified view's text input state is updated.
   // Otherwise the existing state is used.
   SetImeVisibility(uint32 view_id, bool visible, TextInputState? state);
 };
 
 // Changes to views are not sent to the connection that originated the
 // change. For example, if connection 1 changes the bounds of a view by calling
 // SetBounds(), connection 1 does not receive OnViewBoundsChanged().
-interface ViewManagerClient {
+interface ViewTreeClient {
   // Invoked when the client application has been embedded at |root|.
-  // See Embed() on ViewManagerService for more details. |view_manager_service|
-  // will be a handle back to the view manager service, unless the connection is
-  // to the WindowManager in which case it will be null.
+  // See Embed() on ViewTree for more details. |tree| will be a handle back to
+  // the view manager service, unless the connection is to the root connection
+  // in which case it will be null.
   OnEmbed(uint16 connection_id,
           ViewData root,
-          ViewManagerService? view_manager_service,
+          ViewTree? tree,
           uint32 focused_view);
 
-  // Asks the ViewManagerClient that was marked as an embed root for the
-  // ViewManagerClient to embed in |view|. The embed can be disallowed by
+  // Asks the ViewTreeClient that was marked as an embed root for the
+  // ViewTreeClient to embed in |view|. The embed can be disallowed by
   // calling the callback with nullptr.
   OnEmbedForDescendant(uint32 view, URLRequest request) =>
-      (ViewManagerClient? client);
+      (ViewTreeClient? client);
 
   // Invoked when the application embedded at |view| is disconnected.
   OnEmbeddedAppDisconnected(uint32 view);
 
   // Sent when another connection is embedded in the View this connection was
   // previously embedded in. See Embed() for more information.
   OnUnembed();
 
   // Invoked when a view's bounds have changed.
   OnViewBoundsChanged(uint32 view,
@@ skipping 41 matching lines @@
 
   // Invoked when a view property is changed. If this change is a removal,
   // |new_data| is null.
   OnViewSharedPropertyChanged(uint32 view, string name, array<uint8>? new_data);
 
   // Invoked when an event is targeted at the specified view.
   OnViewInputEvent(uint32 view, mojo.Event event) => ();
 
   OnViewFocused(uint32 focused_view_id);
 };