diff options
Diffstat (limited to 'mojo/services/public/cpp/view_manager/view.h')
-rw-r--r-- | mojo/services/public/cpp/view_manager/view.h | 64 |
1 files changed, 60 insertions, 4 deletions
diff --git a/mojo/services/public/cpp/view_manager/view.h b/mojo/services/public/cpp/view_manager/view.h index 72f044c..56d930f 100644 --- a/mojo/services/public/cpp/view_manager/view.h +++ b/mojo/services/public/cpp/view_manager/view.h @@ -23,14 +23,20 @@ class View; class ViewManager; class ViewObserver; +// Defined in view_property.h (which we do not include) +template <typename T> +struct ViewProperty; + // Views are owned by the ViewManager. // TODO(beng): Right now, you'll have to implement a ViewObserver to track // destruction and NULL any pointers you have. // Investigate some kind of smart pointer or weak pointer for these. class View { public: - typedef std::vector<View*> Children; + using Children = std::vector<View*>; + // Creates and returns a new View (which is owned by the ViewManager). Views + // are initially hidden, use SetVisible(true) to show. static View* Create(ViewManager* view_manager); // Destroys this view and all its children. @@ -45,15 +51,45 @@ class View { const Rect& bounds() const { return bounds_; } void SetBounds(const Rect& bounds); - // Visibility (also see IsDrawn()). + // Visibility (also see IsDrawn()). When created views are hidden. bool visible() const { return visible_; } void SetVisible(bool value); - const std::map<std::string, std::vector<uint8_t>>& properties() const { + // Returns the set of string to bag of byte properties. These properties are + // shared with the view manager. + const std::map<std::string, std::vector<uint8_t>>& shared_properties() const { return properties_; } // Sets a property. If |data| is null, this property is deleted. - void SetProperty(const std::string& name, const std::vector<uint8_t>* data); + void SetSharedProperty(const std::string& name, + const std::vector<uint8_t>* data); + + // Sets the |value| of the given window |property|. Setting to the default + // value (e.g., NULL) removes the property. The caller is responsible for the + // lifetime of any object set as a property on the View. + // + // These properties are not visible to the view manager. + template <typename T> + void SetLocalProperty(const ViewProperty<T>* property, T value); + + // Returns the value of the given window |property|. Returns the + // property-specific default value if the property was not previously set. + // + // These properties are only visible in the current process and are not + // shared with other mojo services. + template <typename T> + T GetLocalProperty(const ViewProperty<T>* property) const; + + // Sets the |property| to its default value. Useful for avoiding a cast when + // setting to NULL. + // + // These properties are only visible in the current process and are not + // shared with other mojo services. + template <typename T> + void ClearLocalProperty(const ViewProperty<T>* property); + + // Type of a function to delete a property that this view owns. + typedef void (*PropertyDeallocator)(int64 value); // A View is drawn if the View and all its ancestors are visible and the // View is attached to the root. @@ -67,6 +103,7 @@ class View { View* parent() { return parent_; } const View* parent() const { return parent_; } const Children& children() const { return children_; } + const View* GetRoot() const; void AddChild(View* child); void RemoveChild(View* child); @@ -101,6 +138,14 @@ class View { explicit View(ViewManager* manager); + // Called by the public {Set,Get,Clear}Property functions. + int64 SetLocalPropertyInternal(const void* key, + const char* name, + PropertyDeallocator deallocator, + int64 value, + int64 default_value); + int64 GetLocalPropertyInternal(const void* key, int64 default_value) const; + void LocalDestroy(); void LocalAddChild(View* child); void LocalRemoveChild(View* child); @@ -126,6 +171,17 @@ class View { // state. This field is only used if the view has no parent (eg it's a root). bool drawn_; + // Value struct to keep the name and deallocator for this property. + // Key cannot be used for this purpose because it can be char* or + // WindowProperty<>. + struct Value { + const char* name; + int64 value; + PropertyDeallocator deallocator; + }; + + std::map<const void*, Value> prop_map_; + DISALLOW_COPY_AND_ASSIGN(View); }; |