uattr.hpp

/************************************************************************
 *
 *  uattr.hpp: Base class for the attributes of the Scene Graph
 *  Ubit GUI Toolkit - Version 6
 *  (C) 2009 | Eric Lecolinet | TELECOM ParisTech | http://www.enst.fr/~elc/ubit
 *
 * ***********************************************************************
 * COPYRIGHT NOTICE :
 * THIS PROGRAM IS DISTRIBUTED WITHOUT ANY WARRANTY AND WITHOUT EVEN THE
 * IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
 * YOU CAN REDISTRIBUTE IT AND/OR MODIFY IT UNDER THE TERMS OF THE GNU
 * GENERAL PUBLIC LICENSE AS PUBLISHED BY THE FREE SOFTWARE FOUNDATION;
 * EITHER VERSION 2 OF THE LICENSE, OR (AT YOUR OPTION) ANY LATER VERSION.
 * SEE FILES 'COPYRIGHT' AND 'COPYING' FOR MORE DETAILS.
 * ***********************************************************************/

#ifndef _uattr_hpp_
#define _uattr_hpp_ 1
#include <ubit/unumber.hpp>
namespace ubit {
  
  class UAttr: public UNode {
  public:
    //UCLASS("#attr", UAttr, null)  
    UCLASS(UAttr)  
    
    UAttr();
    UAttr(UConst);
    virtual ~UAttr();
    
    virtual UAttr* toAttr() {return this;}
    virtual const UAttr* toAttr() const {return this;}
     
    virtual int getDisplayType() const {return ATTRIBUTE;}    
    virtual int getNodeType() const {return ATTRIBUTE_NODE;}
    
    virtual const UStr& getNodeName() const {return getClassName();}

    virtual UStr getNodeValue() const;
        
    virtual const UStr& getName() const {return getClassName();}
    
    virtual bool getValue(UStr& value) const;
    virtual void setValue(const UStr& value) {}
    virtual void initNode(UDoc*, UElem* parent) {}

    // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    
    virtual UAttr& onChange(UCall&);
    UAttr& setConst() {UObject::setConst(); return *this;}
    
    virtual void update() {}
    
    // - - - Impl - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    
    virtual void changed(bool update = true);
    virtual void putProp(UUpdateContext*, UElem&) {}
    
  protected:
    friend class UBox;
  };
  
  
  // ==================================================== Ubit Toolkit =========
  class UAttrList : public UAttr {
  public:
    //UCLASS("#attrlist", UAttrList, new UAttrList)
    UCLASS(UAttrList)
    
    void addAttr(UAttr&);
    void addAttr(const UStr& name, const UStr& value);
    
    UStr* getAttr(const UStr&, bool ignore_case = true);
    
    template <class AttrClass> 
    AttrClass* getAttr() const {AttrClass* a; _attributes.findClass(a); return a;}
    template <class AttrClass> 
    AttrClass& obtainAttr() const {AttrClass* a; _attributes.findClass(a); return a ? *a : *new AttrClass;}
    virtual void update();
    virtual void putProp(UUpdateContext*, UElem&);  
  };

  
  // ==================================================== Ubit Toolkit =========
  class UTip: public UAttr {
  public:
    UCLASS(UTip)
    
    UTip(const char* label = null);
    UTip(const UArgs& arglist);
    virtual ~UTip();
    
    //UStr& value() {return *pvalue;}
    // returns the string value.
    
    virtual UTip& set(const char* label);
    virtual UTip& set(const UArgs& arglist);
    
    // - impl. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
#ifndef NO_DOC
    virtual void addingTo(UChild&, UElem& parent);
    virtual void removingFrom(UChild&, UElem& parent);
    //NB: removingFrom() impose un destructeur
    uptr<UNode> content;
#endif
  };
  
  inline UTip& utip(const char* label = null) {return *new UTip(label);}
  
  inline UTip& utip(const UArgs& args) {return *new UTip(args);}
   
  
  
  class UTitle: public UAttr {
  public:
    UCLASS(UTitle)
    
    UTitle(const char* = "");
    UTitle(const UStr&);
    UStr& value() {return *pstring;}
    virtual void update();
    
    // - impl. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
#ifndef NO_DOC
  private:
    uptr<UStr> pstring;
    //bool changed;
#endif
  };
  
  
  inline UTitle& utitle(const char*_s) {return *new UTitle(_s);}
  inline UTitle& utitle(const UStr&_s) {return *new UTitle(_s);}

}
#endif