///////////////////////////////////////////////////////////////////////////////
-// Name: msw/regconf.h
-// Purpose: Registry based implementation of wxConfig
+// Name: msw/regconf.h
+// Purpose: Registry based implementation of wxConfigBase
// Author: Vadim Zeitlin
-// Modified by:
+// Modified by:
// Created: 27.04.98
// RCS-ID: $Id$
// Copyright: (c) 1998 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
-// Licence: wxWindows license
+// Licence: wxWindows licence
///////////////////////////////////////////////////////////////////////////////
#ifndef _REGCONF_H
#define _REGCONF_H
+#ifdef __GNUG__
+#pragma interface "regconf.h"
+#endif
+
+#ifndef _REGISTRY_H
+ #include "wx/msw/registry.h"
+#endif
+#include "wx/object.h"
+
// ----------------------------------------------------------------------------
// wxRegConfig
// ----------------------------------------------------------------------------
-class wxRegConfig : public wxConfig
+class WXDLLEXPORT wxRegConfig : public wxConfigBase
{
public:
// ctor & dtor
- // will store data in HKLM\strRegHive and HKCU\strRegHive
- wxRegConfig(const wxString& strRegHive);
+ // will store data in HKLM\appName and HKCU\appName
+ wxRegConfig(const wxString& appName = _T(""),
+ const wxString& vendorName = _T(""),
+ const wxString& localFilename = _T(""),
+ const wxString& globalFilename = _T(""),
+ long style = 0);
+
// dtor will save unsaved data
virtual ~wxRegConfig();
virtual void SetPath(const wxString& strPath);
virtual const wxString& GetPath() const { return m_strPath; }
- // enum
- virtual bool GetFirstGroup(wxString& str, long& lIndex);
- virtual bool GetNextGroup (wxString& str, long& lIndex);
- virtual bool GetFirstEntry(wxString& str, long& lIndex);
- virtual bool GetNextEntry (wxString& str, long& lIndex);
+ // entry/subgroup info
+ // enumerate all of them
+ virtual bool GetFirstGroup(wxString& str, long& lIndex) const;
+ virtual bool GetNextGroup (wxString& str, long& lIndex) const;
+ virtual bool GetFirstEntry(wxString& str, long& lIndex) const;
+ virtual bool GetNextEntry (wxString& str, long& lIndex) const;
+
+ // tests for existence
+ virtual bool HasGroup(const wxString& strName) const;
+ virtual bool HasEntry(const wxString& strName) const;
+ virtual EntryType GetEntryType(const wxString& name) const;
+
+ // get number of entries/subgroups in the current group, with or without
+ // it's subgroups
+ virtual size_t GetNumberOfEntries(bool bRecursive = FALSE) const;
+ virtual size_t GetNumberOfGroups(bool bRecursive = FALSE) const;
+
+ virtual bool Flush(bool WXUNUSED(bCurrentOnly) = FALSE) { return TRUE; }
- // read/write
- virtual bool Read(wxString&, const char *, const char * = 0) const;
- virtual bool Read(long&, const char *, long = 0) const;
- virtual bool Write(const char *szKey, const char *szValue);
- virtual bool Write(const char *szKey, long Value);
- virtual bool Flush(bool /* bCurrentOnly = FALSE */ ) { return TRUE; }
+ // rename
+ virtual bool RenameEntry(const wxString& oldName, const wxString& newName);
+ virtual bool RenameGroup(const wxString& oldName, const wxString& newName);
// delete
- virtual bool DeleteEntry(const char *szKey, bool bGroupIfEmptyAlso);
- virtual bool DeleteGroup(const char *szKey);
+ virtual bool DeleteEntry(const wxString& key, bool bGroupIfEmptyAlso);
+ virtual bool DeleteGroup(const wxString& key);
virtual bool DeleteAll();
+protected:
+ // opens the local key creating it if necessary and returns it
+ wxRegKey& LocalKey() const // must be const to be callable from const funcs
+ {
+ wxRegConfig* self = wxConstCast(this, wxRegConfig);
+
+ if ( !m_keyLocal.IsOpened() )
+ {
+ // create on demand
+ self->m_keyLocal.Create();
+ }
+
+ return self->m_keyLocal;
+ }
+
+ // implement read/write methods
+ virtual bool DoReadString(const wxString& key, wxString *pStr) const;
+ virtual bool DoReadLong(const wxString& key, long *plResult) const;
+
+ virtual bool DoWriteString(const wxString& key, const wxString& szValue);
+ virtual bool DoWriteLong(const wxString& key, long lValue);
+
private:
+ // no copy ctor/assignment operator
+ wxRegConfig(const wxRegConfig&);
+ wxRegConfig& operator=(const wxRegConfig&);
+
// these keys are opened during all lifetime of wxRegConfig object
wxRegKey m_keyLocalRoot, m_keyLocal,
m_keyGlobalRoot, m_keyGlobal;