jAPIresources.h

Go to the documentation of this file.

//---------------------------------------------------------------------------
#ifndef jAPIresourcesH
#define jAPIresourcesH
//---------------------------------------------------------------------------

#include <registry.hpp>
#include "comctrls.hpp"

// last modification : 23/07/2002

// these functions open the key

/* jREGreadString
@description EN : read the value from a key in the registry
@description FR : lit la valeur d'une clef dans la base de registre
@author : Rémi VERNAY (srvremi@fr.st)
@param _root : HKEY_LOCAL_MACHINE...
@param _key : the key to where is located the subkey
@param _subkey : the subkey associated to the value we want to read
*/
AnsiString __fastcall jREGreadString(HKEY _root, AnsiString _key, AnsiString _subkey);

/* jREGwrite
@description EN : write the value to a key in the registry
@description FR : écrit la valeur d'une clef dans la base de registre
@author : Rémi VERNAY (srvremi@fr.st)
@param _root : HKEY_LOCAL_MACHINE...
@param _key : the key to where will be located situated the subkey
@param _subkey : the subkey associated to the value we want to write
@param _value : the value we want to write
*/
bool __fastcall jREGwrite(HKEY _root, AnsiString _key, AnsiString _subkey, AnsiString _value);

// these functions suppose that the key was previously opened
bool __fastcall jREGwrite(TRegistry * reg, const AnsiString & SubKey, const AnsiString & value);
bool __fastcall jREGread(TRegistry * reg, const AnsiString & SubKey, AnsiString & value);
bool __fastcall jREGwrite(TRegistry * reg, const AnsiString & SubKey,const unsigned int & value);
bool __fastcall jREGread(TRegistry * reg, const AnsiString & SubKey, unsigned int & value);
bool __fastcall jREGwrite(TRegistry * reg, const AnsiString & SubKey,const int & value);
bool __fastcall jREGread(TRegistry * reg, const AnsiString & SubKey, int & value);
bool __fastcall jREGwrite(TRegistry * reg, const AnsiString & SubKey,const bool & value);
bool __fastcall jREGread(TRegistry * reg, const AnsiString & SubKey, bool & value);
bool __fastcall jREGdeleteKey(TRegistry * reg, const AnsiString & Key);
bool __fastcall jREGdeleteKeyAndEmptyParents(TRegistry * reg, const AnsiString & Key);
bool __fastcall jREGparseKey(const AnsiString & Key, TStrings * sl);

class jResources
{
        bool                    created;
        TTreeView *             Tree;
        char                    m_delimiter;

        public :
        jResources();
        jResources(Classes::TComponent * own, bool sorted=false);
        jResources(TTreeView * tree);
        ~jResources()
        {
                if (created)    delete Tree;
        }

        void            __fastcall setDelimiter(char del);
        // acces aux fichiers
        bool            __fastcall crypt(TMemoryStream * ms);
        bool            __fastcall loadFromFile(AnsiString fileName);                   // * charge le fichier de ressource
        bool            __fastcall loadFromStream(TMemoryStream * ms);        
        bool            __fastcall saveToFile(AnsiString fileName);                     // * sauve les ressources dans le fichier
        bool            __fastcall saveToStream(TMemoryStream * ms);        

        // analyse la clef
        bool            __fastcall parseKey(AnsiString key, TStrings * sl);             // # decompose le chemin de la clef en x elements chaine de caractere

        // stockage
        TTreeNode *     __fastcall storeData(TStrings * sl);                            // # stocke les données en ressource
        bool            __fastcall store(AnsiString key, TStrings * sl = NULL);         // * idem mais crée une liste d'élément
        bool            __fastcall storeList(AnsiString key, TStrings * sl);            // * stocke un ensemble de sous-clefs en dessous d'une clef
        bool            __fastcall storeTab(AnsiString key, TListItems * li);           // * stocke un tableau 2x2 (issu d'une liste), en commancant par les labels, puis par les sous labels
        bool            __fastcall storeTabRedondant(AnsiString key, TListItems * li);  // * stocke aussi un tableau, mais stocke les redondances        

        // suppression
        bool            __fastcall remove(TTreeNode * node);                            // # supprime un noeud et ses sous-clefs
        bool            __fastcall remove(AnsiString key);                              // * supprime un clef et ses sous-clefs

        // recherche
        TTreeNode *     __fastcall srchSubNode(AnsiString label, TTreeNode * parent);   // # cherche un sous noeud dans le noeud courant
        TTreeNode *     __fastcall findNode(AnsiString key, bool create = false);       // # renvoit le noeud correspondant à la clef
        bool            __fastcall findData(AnsiString key, AnsiString & res);          // * renvoie la valeur correspondant à la clef (en fait la valeur du premier sous-noeud de la clef)

        // obtention de données
        AnsiString      __fastcall get(AnsiString key);                                 // * 2eme interface pour findData                          
        bool            __fastcall listSubKeys(AnsiString key, TStrings * sl);          // * renvoie la liste des valeurs immédiate sous la clef
        bool            __fastcall listTab(AnsiString key, TListItems * li);            // * renvoie le tableau sous la clef (sous-clefs et sous-sous-clefs) dans une list d'items         

        // modification
        bool            __fastcall modify(AnsiString key, AnsiString texte);            // * modifie la valeur du premier sous_noeud d'une clef
};

#endif

---