Styleable

with styleable logic, you may copy contents from another object easily
to declare a styleable, it's recommended to declare like this:

// in header files:
zfclass YourStyleableObject : zfextend ParentStyleableObject {
    ZFOBJECT_DECLARE(YourStyleableObject, ParentStyleableObject)
    ZFSTYLE_DEFAULT_DECLARE(YourStyleableObject)
};
 
// in cpp files
ZFSTYLE_DEFAULT_DEFINE(YourStyleableObject)

once declared, object's style can be copied as styleable easily:

obj->styleableCopyFrom(anotherStyleableObject);

and you can access default style by the macro generated method:

YourStyle::DefaultStyle();

then, it's convenient to chain different styleable object to achieve simple style logic:

zfclass SomeStyle : zfextend Parent {
    ZFOBJECT_DECLARE(SomeStyle, Parent)
 
    ZFPROPERTY_RETAIN(SomeType, someName, OtherStyle::DefaultStyle()->sth())
};

Advanced styleable

styleable is useful to achieve advance skin logic, use ZFStyleable::styleKey to supply your style:

yourObj->styleKey("your_skin_key");

this code register yourObj to ZFStyleSet, once the skin value associated with "your_skin_key" has changed by ZFStyleChangeEnd, yourObj would be notified and copy style from it automatically

for non-ZFStyleable property, you may also attach to style if it's registered by ZFTYPEID_DECLARE

yourObj->styleKeyForProperty(ZFPropertyAccess(YourObject, yourProperty), "your_skin_key");

also, thanks to ZFClass's instance observer, you may achieve more complex style logic:

ZFLISTENER(myObjCreated) {
    MyStyleableObject *obj = zfargs.sender();
 
    // change default setting for all instance of MyStyleableObject
    obj->myProperty(xxx);
 
    // or apply style copy (consume more CPU)
    obj->styleableCopyFrom(yyy);
} ZFLISTENER_END()
MyStyleableObject::ClassData()->instanceObserverAdd(myObjCreated);