Tag as full crow property + comments

diff --git a/src/GraphicObjects/GraphicObject.cs b/src/GraphicObjects/GraphicObject.cs
index e0f1ebfd37cdc68dc8b22e85b0d32962c8b47fda..70334e127d0184d2a748fe1cdc9a9fa51750dcd2 100644 (file)
--- a/src/GraphicObjects/GraphicObject.cs
+++ b/src/GraphicObjects/GraphicObject.cs
@@ -82,6 +82,7 @@ namespace Crow
                bool clipToClientRect = true;
                protected object dataSource;
                string style;
+               object tag;
                #endregion
 
                #region public fields
@@ -103,8 +104,6 @@ namespace Crow
                public Rectangle LastPaintedSlot;
                /// <summary>Prevent requeuing multiple times the same widget</summary>
                public bool IsQueueForRedraw = false;
-               /// <summary>Random value placeholder</summary>
-               public object Tag;
                /// <summary>drawing Cache, if null, a redraw is done, cached or not</summary>
                public byte[] bmp;
                public bool IsDirty = true;
@@ -195,7 +194,22 @@ namespace Crow
                #endregion
 
                #region public properties
-               [XmlAttributeAttribute()][DefaultValue(true)]
+               /// <summary>Random value placeholder</summary>
+               [XmlAttributeAttribute]
+               public object Tag {
+                       get { return tag; }
+                       set {
+                               if (tag == value)
+                                       return;
+                               tag = value;
+                               NotifyValueChanged ("Tag", tag);
+                       }
+               }
+               /// <summary>
+               /// If enabled, resulting bitmap of graphic object is cached in an byte array
+               /// speeding up rendering of complex object. Default is enabled.
+               /// </summary>
+               [XmlAttributeAttribute][DefaultValue(true)]
                public virtual bool CacheEnabled {
                        get { return cacheEnabled; }
                        set {
@@ -205,7 +219,10 @@ namespace Crow
                                NotifyValueChanged ("CacheEnabled", cacheEnabled);
                        }
                }
-               [XmlAttributeAttribute()][DefaultValue(true)]
+               /// <summary>
+               /// If true, rendering of GraphicObject is clipped inside client rectangle
+               /// </summary>
+               [XmlAttributeAttribute][DefaultValue(true)]
                public virtual bool ClipToClientRect {
                        get { return clipToClientRect; }
                        set {
@@ -216,7 +233,10 @@ namespace Crow
                                this.RegisterForRedraw ();
                        }
                }
-               [XmlAttributeAttribute()][DefaultValue(null)]
+               /// <summary>
+               /// Name is used in binding to reference other GraphicObjects inside the graphic tree
+               /// </summary>
+               [XmlAttributeAttribute][DefaultValue(null)]
                public virtual string Name {
                        get {
                                #if DEBUG