#ifndef _REGISTRY_H
#define _REGISTRY_H
-#ifdef __GNUG__
+#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
#pragma interface "registry.h"
#endif
// ----------------------------------------------------------------------------
// class wxRegKey encapsulates window HKEY handle
// ----------------------------------------------------------------------------
-class WXDLLEXPORT wxRegKey
+class WXDLLIMPEXP_BASE wxRegKey
{
public:
// NB: do _not_ change the values of elements in these enumerations!
#endif // Win32/16
};
+ // access mode for the key
+ enum AccessMode
+ {
+ Read, // read-only
+ Write // read and write
+ };
+
// information about standard (predefined) registry keys
// number of standard keys
static const size_t nStdKeys;
wxRegKey(StdKey keyParent, const wxString& strKey);
// strKey is the name of key under (previously created) keyParent
wxRegKey(const wxRegKey& keyParent, const wxString& strKey);
- //
+ // dtor closes the key
~wxRegKey();
// change key (closes the previously opened key if any)
// get infomation about the key
// get the (full) key name. Abbreviate std root keys if bShortPrefix.
- wxString GetName(bool bShortPrefix = TRUE) const;
+ wxString GetName(bool bShortPrefix = true) const;
// return true if the key exists
bool Exists() const;
// get the info about key (any number of these pointers may be NULL)
// operations on the key itself
// explicitly open the key (will be automatically done by all functions
// which need the key to be opened if the key is not opened yet)
- bool Open();
+ bool Open(AccessMode mode = Write);
// create the key: will fail if the key already exists and !bOkIfExists
- bool Create(bool bOkIfExists = TRUE);
+ 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
// access to values and subkeys
// get value type
ValueType GetValueType(const wxChar *szValue) const;
- // returns TRUE if the value contains a number (else it's some string)
+ // returns true if the value contains a number (else it's some string)
bool IsNumericValue(const wxChar *szValue) const;
// assignment operators set the default value of the key
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);
// retrieve the string value
bool QueryValue(const wxChar *szValue, wxString& strValue) const
- { return QueryValue(szValue, strValue, FALSE); }
+ { return QueryValue(szValue, strValue, false); }
// retrieve raw string value
bool QueryRawValue(const wxChar *szValue, wxString& strValue) const
- { return QueryValue(szValue, strValue, TRUE); }
+ { return QueryValue(szValue, strValue, true); }
// retrieve either raw or expanded string value
bool QueryValue(const wxChar *szValue, wxString& strValue, bool raw) const;
bool SetValue(const wxChar *szValue, long lValue);
// return the numeric value
bool QueryValue(const wxChar *szValue, long *plValue) const;
+ // set the binary value
+ bool SetValue(const wxChar *szValue, const wxMemoryBuffer& buf);
+ // return the binary value
+ bool QueryValue(const wxChar *szValue, wxMemoryBuffer& buf) const;
#endif //Win32
// query existence of a key/value