X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/2bda0e173844e8e0f8acf4e8ad8b5c26e5c6fe5d..b5279053f65f2f4f7352d2a74c787096073e3ad6:/include/wx/msw/registry.h diff --git a/include/wx/msw/registry.h b/include/wx/msw/registry.h index adacf76944..e63bffb607 100644 --- a/include/wx/msw/registry.h +++ b/include/wx/msw/registry.h @@ -12,6 +12,10 @@ #ifndef _REGISTRY_H #define _REGISTRY_H +#ifdef __GNUG__ +#pragma interface "registry.h" +#endif + // ---------------------------------------------------------------------------- // mutable hack (see also registry.cpp) // ---------------------------------------------------------------------------- @@ -22,13 +26,15 @@ #endif // ---------------------------------------------------------------------------- -// forward decl for handle type +// types used in this module // ---------------------------------------------------------------------------- #ifndef HKEY_DEFINED #define HKEY_DEFINED #define HKEY unsigned long #endif +typedef unsigned long ulong; + // ---------------------------------------------------------------------------- // class wxRegKey encapsulates window HKEY handle // ---------------------------------------------------------------------------- @@ -93,23 +99,34 @@ public: // strKey is the full name of the key (i.e. starting with HKEY_xxx...) wxRegKey(const wxString& strKey); // strKey is the name of key under (standard key) keyParent - wxRegKey(StdKey keyParent, const wxString& strKey); + wxRegKey(StdKey keyParent, const wxString& strKey); // strKey is the name of key under (previously created) keyParent wxRegKey(const wxRegKey& keyParent, const wxString& strKey); // ~wxRegKey(); // change key (closes the previously opened key if any) + // the name is absolute, i.e. should start with HKEY_xxx void SetName(const wxString& strKey); - void SetHkey(HKEY hKey); + // the name is relative to the parent key + void SetName(StdKey keyParent, const wxString& strKey); + // the name is relative to the parent key + void SetName(const wxRegKey& keyParent, const wxString& strKey); + // hKey should be opened and will be closed in wxRegKey dtor + void SetHkey(HKEY hKey); // get infomation about the key // get the (full) key name. Abbreviate std root keys if bShortPrefix. wxString GetName(bool bShortPrefix = TRUE) const; - // return TRUE if the key exists - bool Exists() const; - // return TRUE if the key is opened - bool IsOpened() const { return m_hKey != 0; } + // return true if the key exists + bool Exists() const; + // get the info about key (any number of these pointers may be NULL) + bool GetKeyInfo(ulong *pnSubKeys, // number of subkeys + ulong *pnMaxKeyLen, // max len of subkey name + ulong *pnValues, // number of values + ulong *pnMaxValueLen) const; + // return true if the key is opened + bool IsOpened() const { return m_hKey != 0; } // for "if ( !key ) wxLogError(...)" kind of expressions operator bool() const { return m_dwLastError == 0; } @@ -155,16 +172,17 @@ public: bool QueryValue(const char *szValue, long *plValue) const; #endif //Win32 - // return TRUE if given subkey exists + // query existence of a key/value + // return true if value exists + bool HasValue(const char *szKey) const; + // return true if given subkey exists bool HasSubKey(const char *szKey) const; - // return TRUE if any subkeys exist + // return true if any subkeys exist bool HasSubkeys() const; // enumerate values and subkeys -#ifdef __WIN32__ bool GetFirstValue(wxString& strValueName, long& lIndex); bool GetNextValue (wxString& strValueName, long& lIndex) const; -#endif //Win32 bool GetFirstKey (wxString& strKeyName , long& lIndex); bool GetNextKey (wxString& strKeyName , long& lIndex) const; @@ -182,3 +200,4 @@ private: }; #endif //_REGISTRY_H +