components/mus/public/cpp/view_tree_connection.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_MUS_PUBLIC_CPP_VIEW_TREE_CONNECTION_H_
   6 #define COMPONENTS_MUS_PUBLIC_CPP_VIEW_TREE_CONNECTION_H_
   7
   8 #include <string>
   9
  10 #include "components/mus/public/cpp/types.h"
  11 #include "components/mus/public/interfaces/view_tree.mojom.h"
  12 #include "third_party/mojo/src/mojo/public/cpp/bindings/interface_request.h"
  13
  14 namespace mus {
  15
  16 class View;
  17 class ViewTreeDelegate;
  18
  19 // Encapsulates a connection to a view tree. A unique connection is made
  20 // every time an app is embedded.
  21 class ViewTreeConnection {
  22  public:
  23   virtual ~ViewTreeConnection() {}
  24
  25   // The returned ViewTreeConnection instance owns itself, and is deleted when
  26   // the last root is destroyed or the connection to the service is broken.
  27   static ViewTreeConnection* Create(
  28       ViewTreeDelegate* delegate,
  29       mojo::InterfaceRequest<mojo::ViewTreeClient> request);
  30
  31   // Returns the root of this connection.
  32   virtual View* GetRoot() = 0;
  33
  34   // Returns a View known to this connection.
  35   virtual View* GetViewById(Id id) = 0;
  36
  37   // Returns the focused view; null if focus is not yet known or another app is
  38   // focused.
  39   virtual View* GetFocusedView() = 0;
  40
  41   // Creates and returns a new View (which is owned by the ViewManager). Views
  42   // are initially hidden, use SetVisible(true) to show.
  43   virtual View* CreateView() = 0;
  44
  45   // Returns true if ACCESS_POLICY_EMBED_ROOT was specified.
  46   virtual bool IsEmbedRoot() = 0;
  47
  48   // Returns the id for this connection.
  49   virtual ConnectionSpecificId GetConnectionId() = 0;
  50 };
  51
  52 }  // namespace mus
  53
  54 #endif  // COMPONENTS_MUS_PUBLIC_CPP_VIEW_TREE_CONNECTION_H_