#pragma interface "registry.h"
#endif
-// ----------------------------------------------------------------------------
-// mutable hack (see also registry.cpp)
-// ----------------------------------------------------------------------------
-#if wxUSE_MUTABLE
- #define MUTABLE mutable
-#else
- #define MUTABLE
-#endif
-
// ----------------------------------------------------------------------------
// types used in this module
// ----------------------------------------------------------------------------
bool Create(bool bOkIfExists = TRUE);
// rename a value from old name to new one
bool RenameValue(const wxChar *szValueOld, const wxChar *szValueNew);
+ // rename the key
+ bool Rename(const wxChar *szNewName);
// copy value to another key possibly changing its name (by default it will
// remain the same)
bool CopyValue(const wxChar *szValue, wxRegKey& keyDst,
const wxChar *szNewName = NULL);
// copy the entire contents of the key recursively to another location
- bool Copy(const wxString& strNewName);
+ bool Copy(const wxChar *szNewName);
// same as Copy() but using a key and not the name
bool Copy(wxRegKey& keyDst);
// close the key (will be automatically done in dtor)
wxRegKey& operator=(long lValue)
{ SetValue(NULL, lValue); return *this; }
- // conversion operators query the default value of the key
- operator wxString() const;
+ // query the default value of the key: implicitly or explicitly
+ wxString QueryDefaultValue() const;
+ operator wxString() const { return QueryDefaultValue(); }
+
+ // named values
// set the string value
bool SetValue(const wxChar *szValue, const wxString& strValue);
- // return the string value
- bool QueryValue(const wxChar *szValue, wxString& strValue) const;
+ // retrieve the string value
+ bool QueryValue(const wxChar *szValue, wxString& strValue) const
+ { return QueryValue(szValue, strValue, FALSE); }
+ // retrieve raw string value
+ bool QueryRawValue(const wxChar *szValue, wxString& strValue) const
+ { return QueryValue(szValue, strValue, TRUE); }
+ // retrieve either raw or expanded string value
+ bool QueryValue(const wxChar *szValue, wxString& strValue, bool raw) const;
#ifdef __WIN32__
// set the numeric value
bool GetFirstKey (wxString& strKeyName , long& lIndex);
bool GetNextKey (wxString& strKeyName , long& lIndex) const;
+ // for wxRegConfig usage only: preallocate some memory for the name
+ void ReserveMemoryForName(size_t bytes) { m_strKey.reserve(bytes); }
+
private:
+ // common part of all ctors
+ void Init()
+ {
+ m_hKey = (WXHKEY) NULL;
+ m_dwLastError = 0;
+ }
+
// no copy ctor/assignment operator
wxRegKey(const wxRegKey& key); // not implemented
wxRegKey& operator=(const wxRegKey& key); // not implemented
m_hRootKey; // handle of the top key (i.e. StdKey)
wxString m_strKey; // key name (relative to m_hRootKey)
- MUTABLE long m_dwLastError; // last error (0 if none)
+ long m_dwLastError; // last error (0 if none)
};
#endif //_REGISTRY_H