4c51a665c6
Applied patch by snowleopard2 fixing a bunch of typos such as misspellings and double words in the documentation. Combined the patch with some local queued typos waiting to be committed as well as adding new typo fixes inspired by the patch.
Function names with American spelling were not changed nor was third-party code touched. The only code changes involve some changes in strings that are translated ("Can not" -> "Cannot").
Closes #13063 (again).
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@67280 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
277 lines
10 KiB
C++
277 lines
10 KiB
C++
///////////////////////////////////////////////////////////////////////////////
|
|
// Name: wx/msw/registry.h
|
|
// Purpose: Registry classes and functions
|
|
// Author: Vadim Zeitlin
|
|
// Modified by:
|
|
// Created: 03.04.1998
|
|
// RCS-ID: $Id$
|
|
// Copyright: (c) 1998 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
|
|
// Licence: wxWindows licence
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef _WX_MSW_REGISTRY_H_
|
|
#define _WX_MSW_REGISTRY_H_
|
|
|
|
#include "wx/defs.h"
|
|
|
|
#if wxUSE_REGKEY
|
|
|
|
class WXDLLIMPEXP_FWD_BASE wxOutputStream;
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// class wxRegKey encapsulates window HKEY handle
|
|
// ----------------------------------------------------------------------------
|
|
|
|
class WXDLLIMPEXP_BASE wxRegKey
|
|
{
|
|
public:
|
|
// NB: do _not_ change the values of elements in these enumerations!
|
|
|
|
// registry value types (with comments from winnt.h)
|
|
enum ValueType
|
|
{
|
|
Type_None, // No value type
|
|
Type_String, // Unicode nul terminated string
|
|
Type_Expand_String, // Unicode nul terminated string
|
|
// (with environment variable references)
|
|
Type_Binary, // Free form binary
|
|
Type_Dword, // 32-bit number
|
|
Type_Dword_little_endian // 32-bit number
|
|
= Type_Dword, // (same as Type_DWORD)
|
|
Type_Dword_big_endian, // 32-bit number
|
|
Type_Link, // Symbolic Link (unicode)
|
|
Type_Multi_String, // Multiple Unicode strings
|
|
Type_Resource_list, // Resource list in the resource map
|
|
Type_Full_resource_descriptor, // Resource list in the hardware description
|
|
Type_Resource_requirements_list // ???
|
|
};
|
|
|
|
// predefined registry keys
|
|
enum StdKey
|
|
{
|
|
HKCR, // classes root
|
|
HKCU, // current user
|
|
HKLM, // local machine
|
|
HKUSR, // users
|
|
HKPD, // performance data (WinNT/2K only)
|
|
HKCC, // current config
|
|
HKDD, // dynamic data (Win95/98 only)
|
|
HKMAX
|
|
};
|
|
|
|
// access mode for the key
|
|
enum AccessMode
|
|
{
|
|
Read, // read-only
|
|
Write // read and write
|
|
};
|
|
|
|
// Different registry views supported under WOW64.
|
|
enum WOW64ViewMode
|
|
{
|
|
// 32 bit registry for 32 bit applications, 64 bit registry
|
|
// for 64 bit ones.
|
|
WOW64ViewMode_Default,
|
|
|
|
// Can be used in 64 bit apps to access 32 bit registry,
|
|
// has no effect (i.e. treated as default) in 32 bit apps.
|
|
WOW64ViewMode_32,
|
|
|
|
// Can be used in 32 bit apps to access 64 bit registry,
|
|
// has no effect (i.e. treated as default) in 64 bit apps.
|
|
WOW64ViewMode_64
|
|
};
|
|
|
|
// information about standard (predefined) registry keys
|
|
// number of standard keys
|
|
static const size_t nStdKeys;
|
|
// get the name of a standard key
|
|
static const wxChar *GetStdKeyName(size_t key);
|
|
// get the short name of a standard key
|
|
static const wxChar *GetStdKeyShortName(size_t key);
|
|
// get StdKey from root HKEY
|
|
static StdKey GetStdKeyFromHkey(WXHKEY hkey);
|
|
|
|
// extracts the std key prefix from the string (return value) and
|
|
// leaves only the part after it (i.e. modifies the string passed!)
|
|
static StdKey ExtractKeyName(wxString& str);
|
|
|
|
// ctors
|
|
// root key is set to HKCR (the only root key under Win16)
|
|
wxRegKey(WOW64ViewMode viewMode = WOW64ViewMode_Default);
|
|
|
|
// strKey is the full name of the key (i.e. starting with HKEY_xxx...)
|
|
wxRegKey(const wxString& strKey,
|
|
WOW64ViewMode viewMode = WOW64ViewMode_Default);
|
|
|
|
// strKey is the name of key under (standard key) keyParent
|
|
wxRegKey(StdKey keyParent,
|
|
const wxString& strKey,
|
|
WOW64ViewMode viewMode = WOW64ViewMode_Default);
|
|
|
|
// 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)
|
|
// the name is absolute, i.e. should start with HKEY_xxx
|
|
void SetName(const wxString& strKey);
|
|
// 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(WXHKEY hKey);
|
|
|
|
// get infomation about the key
|
|
// get the (full) key name. Abbreviate std root keys if bShortPrefix.
|
|
wxString GetName(bool bShortPrefix = true) const;
|
|
// Retrieves the registry view used by this key.
|
|
WOW64ViewMode GetView() const { return m_viewMode; }
|
|
// return true if the key exists
|
|
bool Exists() const;
|
|
// get the info about key (any number of these pointers may be NULL)
|
|
bool GetKeyInfo(size_t *pnSubKeys, // number of subkeys
|
|
size_t *pnMaxKeyLen, // max len of subkey name
|
|
size_t *pnValues, // number of values
|
|
size_t *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; }
|
|
|
|
// 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(AccessMode mode = Write);
|
|
// create the key: will fail if the key already exists and !bOkIfExists
|
|
bool Create(bool bOkIfExists = true);
|
|
// rename a value from old name to new one
|
|
bool RenameValue(const wxString& szValueOld, const wxString& szValueNew);
|
|
// rename the key
|
|
bool Rename(const wxString& szNewName);
|
|
// copy value to another key possibly changing its name (by default it will
|
|
// remain the same)
|
|
bool CopyValue(const wxString& szValue, wxRegKey& keyDst,
|
|
const wxString& szNewName = wxEmptyString);
|
|
|
|
// copy the entire contents of the key recursively to another location
|
|
bool Copy(const wxString& 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)
|
|
bool Close();
|
|
|
|
// deleting keys/values
|
|
// deletes this key and all of it's subkeys/values
|
|
bool DeleteSelf();
|
|
// deletes the subkey with all of it's subkeys/values recursively
|
|
bool DeleteKey(const wxString& szKey);
|
|
// deletes the named value (may be empty string to remove the default value)
|
|
bool DeleteValue(const wxString& szValue);
|
|
|
|
// access to values and subkeys
|
|
// get value type
|
|
ValueType GetValueType(const wxString& szValue) const;
|
|
// returns true if the value contains a number (else it's some string)
|
|
bool IsNumericValue(const wxString& szValue) const;
|
|
|
|
// assignment operators set the default value of the key
|
|
wxRegKey& operator=(const wxString& strValue)
|
|
{ SetValue(wxEmptyString, strValue); return *this; }
|
|
|
|
// 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 wxString& szValue, const wxString& strValue);
|
|
// retrieve the string value
|
|
bool QueryValue(const wxString& szValue, wxString& strValue) const
|
|
{ return QueryValue(szValue, strValue, false); }
|
|
// retrieve raw string value
|
|
bool QueryRawValue(const wxString& szValue, wxString& strValue) const
|
|
{ return QueryValue(szValue, strValue, true); }
|
|
// retrieve either raw or expanded string value
|
|
bool QueryValue(const wxString& szValue, wxString& strValue, bool raw) const;
|
|
|
|
// set the numeric value
|
|
bool SetValue(const wxString& szValue, long lValue);
|
|
// return the numeric value
|
|
bool QueryValue(const wxString& szValue, long *plValue) const;
|
|
// set the binary value
|
|
bool SetValue(const wxString& szValue, const wxMemoryBuffer& buf);
|
|
// return the binary value
|
|
bool QueryValue(const wxString& szValue, wxMemoryBuffer& buf) const;
|
|
|
|
// query existence of a key/value
|
|
// return true if value exists
|
|
bool HasValue(const wxString& szKey) const;
|
|
// return true if given subkey exists
|
|
bool HasSubKey(const wxString& szKey) const;
|
|
// return true if any subkeys exist
|
|
bool HasSubkeys() const;
|
|
// return true if any values exist
|
|
bool HasValues() const;
|
|
// return true if the key is empty (nothing under this key)
|
|
bool IsEmpty() const { return !HasSubkeys() && !HasValues(); }
|
|
|
|
// enumerate values and subkeys
|
|
bool GetFirstValue(wxString& strValueName, long& lIndex);
|
|
bool GetNextValue (wxString& strValueName, long& lIndex) const;
|
|
|
|
bool GetFirstKey (wxString& strKeyName , long& lIndex);
|
|
bool GetNextKey (wxString& strKeyName , long& lIndex) const;
|
|
|
|
// export the contents of this key and all its subkeys to the given file
|
|
// (which won't be overwritten, it's an error if it already exists)
|
|
//
|
|
// note that we export the key in REGEDIT4 format, not RegSaveKey() binary
|
|
// format nor newer REGEDIT5 one
|
|
bool Export(const wxString& filename) const;
|
|
|
|
// same as above but write to the given (opened) stream
|
|
bool Export(wxOutputStream& ostr) 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;
|
|
}
|
|
|
|
// recursive helper for Export()
|
|
bool DoExport(wxOutputStream& ostr) const;
|
|
|
|
// export a single value
|
|
bool DoExportValue(wxOutputStream& ostr, const wxString& name) const;
|
|
|
|
// return the text representation (in REGEDIT4 format) of the value with the
|
|
// given name
|
|
wxString FormatValue(const wxString& name) const;
|
|
|
|
|
|
WXHKEY m_hKey, // our handle
|
|
m_hRootKey; // handle of the top key (i.e. StdKey)
|
|
wxString m_strKey; // key name (relative to m_hRootKey)
|
|
WOW64ViewMode m_viewMode; // which view to select under WOW64
|
|
AccessMode m_mode; // valid only if key is opened
|
|
long m_dwLastError; // last error (0 if none)
|
|
|
|
|
|
wxDECLARE_NO_COPY_CLASS(wxRegKey);
|
|
};
|
|
|
|
#endif // wxUSE_REGKEY
|
|
|
|
#endif // _WX_MSW_REGISTRY_H_
|
|
|