| OLD | NEW |
| (Empty) |
| 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_VIEW_MANAGER_PUBLIC_CPP_VIEW_TREE_DELEGATE_H_ | |
| 6 #define COMPONENTS_VIEW_MANAGER_PUBLIC_CPP_VIEW_TREE_DELEGATE_H_ | |
| 7 | |
| 8 #include <string> | |
| 9 | |
| 10 #include "components/view_manager/public/interfaces/view_tree.mojom.h" | |
| 11 #include "mojo/application/public/interfaces/service_provider.mojom.h" | |
| 12 #include "mojo/services/network/public/interfaces/url_loader.mojom.h" | |
| 13 | |
| 14 namespace mojo { | |
| 15 | |
| 16 class View; | |
| 17 class ViewTreeConnection; | |
| 18 | |
| 19 // Interface implemented by an application using the view manager. | |
| 20 // | |
| 21 // Each call to OnEmbed() results in a new ViewTreeConnection and new root View. | |
| 22 // ViewTreeConnection is deleted by any of the following: | |
| 23 // . If the root of the connection is destroyed. This happens if the owner | |
| 24 // of the root Embed()s another app in root, or the owner explicitly deletes | |
| 25 // root. | |
| 26 // . The connection to the view manager is lost. | |
| 27 // . Explicitly by way of calling delete. | |
| 28 // | |
| 29 // When the ViewTreeConnection is deleted all views are deleted (and observers | |
| 30 // notified). This is followed by notifying the delegate by way of | |
| 31 // OnConnectionLost(). | |
| 32 class ViewTreeDelegate { | |
| 33 public: | |
| 34 // Called when the application implementing this interface is embedded at | |
| 35 // |root|. | |
| 36 // | |
| 37 // |services| exposes the services offered by the embedder to the delegate. | |
| 38 // | |
| 39 // |exposed_services| is an object that the delegate can add services to | |
| 40 // expose to the embedder. | |
| 41 // | |
| 42 // Note that if a different application is subsequently embedded at |root|, | |
| 43 // the pipes connecting |services| and |exposed_services| to the embedder and | |
| 44 // any services obtained from them are not broken and will continue to be | |
| 45 // valid. | |
| 46 virtual void OnEmbed(View* root) = 0; | |
| 47 | |
| 48 // Sent when another app is embedded in the same View as this connection. | |
| 49 // Subsequently the root View and this object are destroyed (observers are | |
| 50 // notified appropriately). | |
| 51 virtual void OnUnembed(); | |
| 52 | |
| 53 // Called from the destructor of ViewTreeConnection after all the Views have | |
| 54 // been destroyed. |connection| is no longer valid after this call. | |
| 55 virtual void OnConnectionLost(ViewTreeConnection* connection) = 0; | |
| 56 | |
| 57 protected: | |
| 58 virtual ~ViewTreeDelegate() {} | |
| 59 }; | |
| 60 | |
| 61 } // namespace mojo | |
| 62 | |
| 63 #endif // COMPONENTS_VIEW_MANAGER_PUBLIC_CPP_VIEW_TREE_DELEGATE_H_ | |
| OLD | NEW |