JUCE
Public Types | Public Member Functions | Static Public Member Functions | List of all members
WindowsRegistry Class Reference

Contains some static helper functions for manipulating the MS Windows registry (Only available on Windows, of course!) More...

Public Types

enum  WoW64Mode { WoW64_Default = 0, WoW64_64bit = 0x100, WoW64_32bit = 0x200 }
 These values can be used to specify whether the 32- or 64-bit registry should be used. More...
 

Public Member Functions

 JUCE_DEPRECATED (static String getValueWow64(const String &, const String &defaultValue=String()))
 
 JUCE_DEPRECATED (static bool valueExistsWow64(const String &))
 
 JUCE_DEPRECATED (static bool keyExistsWow64(const String &))
 

Static Public Member Functions

static String JUCE_CALLTYPE getValue (const String &regValuePath, const String &defaultValue=String(), WoW64Mode mode=WoW64_Default)
 Returns a string from the registry. More...
 
static uint32 JUCE_CALLTYPE getBinaryValue (const String &regValuePath, MemoryBlock &resultData, WoW64Mode mode=WoW64_Default)
 Reads a binary block from the registry. More...
 
static bool JUCE_CALLTYPE setValue (const String &regValuePath, const String &value, WoW64Mode mode=WoW64_Default)
 Sets a registry value as a string. More...
 
static bool JUCE_CALLTYPE setValue (const String &regValuePath, uint32 value, WoW64Mode mode=WoW64_Default)
 Sets a registry value as a DWORD. More...
 
static bool JUCE_CALLTYPE setValue (const String &regValuePath, uint64 value, WoW64Mode mode=WoW64_Default)
 Sets a registry value as a QWORD. More...
 
static bool JUCE_CALLTYPE setValue (const String &regValuePath, const MemoryBlock &value, WoW64Mode mode=WoW64_Default)
 Sets a registry value as a binary block. More...
 
static bool JUCE_CALLTYPE valueExists (const String &regValuePath, WoW64Mode mode=WoW64_Default)
 Returns true if the given value exists in the registry. More...
 
static bool JUCE_CALLTYPE keyExists (const String &regKeyPath, WoW64Mode mode=WoW64_Default)
 Returns true if the given key exists in the registry. More...
 
static bool JUCE_CALLTYPE deleteValue (const String &regValuePath, WoW64Mode mode=WoW64_Default)
 Deletes a registry value. More...
 
static bool JUCE_CALLTYPE deleteKey (const String &regKeyPath, WoW64Mode mode=WoW64_Default)
 Deletes a registry key (which is registry-talk for 'folder'). More...
 
static bool JUCE_CALLTYPE registerFileAssociation (const String &fileExtension, const String &symbolicDescription, const String &fullDescription, const File &targetExecutable, int iconResourceNumber, bool registerForCurrentUserOnly, WoW64Mode mode=WoW64_Default)
 Creates a file association in the registry. More...
 

Detailed Description

Contains some static helper functions for manipulating the MS Windows registry (Only available on Windows, of course!)

Member Enumeration Documentation

◆ WoW64Mode

These values can be used to specify whether the 32- or 64-bit registry should be used.

When running on a 32-bit OS, there is no 64-bit registry, so the mode will be ignored.

Enumerator
WoW64_Default 

Default handling: 32-bit apps will use the 32-bit registry, and 64-bit apps will use the 64-bit registry.

WoW64_64bit 

Always use the 64-bit registry store.

(KEY_WOW64_64KEY).

WoW64_32bit 

Always use the 32-bit registry store.

(KEY_WOW64_32KEY).

Member Function Documentation

◆ getValue()

static String JUCE_CALLTYPE WindowsRegistry::getValue ( const String regValuePath,
const String defaultValue = String(),
WoW64Mode  mode = WoW64_Default 
)
static

Returns a string from the registry.

The path is a string for the entire path of a value in the registry, e.g. "HKEY_CURRENT_USER\Software\foo\bar"

◆ getBinaryValue()

static uint32 JUCE_CALLTYPE WindowsRegistry::getBinaryValue ( const String regValuePath,
MemoryBlock resultData,
WoW64Mode  mode = WoW64_Default 
)
static

Reads a binary block from the registry.

The path is a string for the entire path of a value in the registry, e.g. "HKEY_CURRENT_USER\Software\foo\bar"

Returns
a DWORD indicating the type of the key.

◆ setValue() [1/4]

static bool JUCE_CALLTYPE WindowsRegistry::setValue ( const String regValuePath,
const String value,
WoW64Mode  mode = WoW64_Default 
)
static

Sets a registry value as a string.

This will take care of creating any groups needed to get to the given registry value.

◆ setValue() [2/4]

static bool JUCE_CALLTYPE WindowsRegistry::setValue ( const String regValuePath,
uint32  value,
WoW64Mode  mode = WoW64_Default 
)
static

Sets a registry value as a DWORD.

This will take care of creating any groups needed to get to the given registry value.

◆ setValue() [3/4]

static bool JUCE_CALLTYPE WindowsRegistry::setValue ( const String regValuePath,
uint64  value,
WoW64Mode  mode = WoW64_Default 
)
static

Sets a registry value as a QWORD.

This will take care of creating any groups needed to get to the given registry value.

◆ setValue() [4/4]

static bool JUCE_CALLTYPE WindowsRegistry::setValue ( const String regValuePath,
const MemoryBlock value,
WoW64Mode  mode = WoW64_Default 
)
static

Sets a registry value as a binary block.

This will take care of creating any groups needed to get to the given registry value.

◆ valueExists()

static bool JUCE_CALLTYPE WindowsRegistry::valueExists ( const String regValuePath,
WoW64Mode  mode = WoW64_Default 
)
static

Returns true if the given value exists in the registry.

◆ keyExists()

static bool JUCE_CALLTYPE WindowsRegistry::keyExists ( const String regKeyPath,
WoW64Mode  mode = WoW64_Default 
)
static

Returns true if the given key exists in the registry.

◆ deleteValue()

static bool JUCE_CALLTYPE WindowsRegistry::deleteValue ( const String regValuePath,
WoW64Mode  mode = WoW64_Default 
)
static

Deletes a registry value.

◆ deleteKey()

static bool JUCE_CALLTYPE WindowsRegistry::deleteKey ( const String regKeyPath,
WoW64Mode  mode = WoW64_Default 
)
static

Deletes a registry key (which is registry-talk for 'folder').

◆ registerFileAssociation()

static bool JUCE_CALLTYPE WindowsRegistry::registerFileAssociation ( const String fileExtension,
const String symbolicDescription,
const String fullDescription,
const File targetExecutable,
int  iconResourceNumber,
bool  registerForCurrentUserOnly,
WoW64Mode  mode = WoW64_Default 
)
static

Creates a file association in the registry.

This lets you set the executable that should be launched by a given file extension.

Parameters
fileExtensionthe file extension to associate, including the initial dot, e.g. ".txt"
symbolicDescriptiona space-free short token to identify the file type
fullDescriptiona human-readable description of the file type
targetExecutablethe executable that should be launched
iconResourceNumberthe icon that gets displayed for the file type will be found by looking up this resource number in the executable. Pass 0 here to not use an icon
registerForCurrentUserOnlyif false, this will try to register the association for all users (you might not have permission to do this unless running in an installer). If true, it will register the association in HKEY_CURRENT_USER.
modethe WoW64 mode to use for choosing the database

◆ JUCE_DEPRECATED() [1/3]

WindowsRegistry::JUCE_DEPRECATED ( static String   getValueWow64const String &, const String &defaultValue=String())

◆ JUCE_DEPRECATED() [2/3]

WindowsRegistry::JUCE_DEPRECATED ( static bool   valueExistsWow64const String &)

◆ JUCE_DEPRECATED() [3/3]

WindowsRegistry::JUCE_DEPRECATED ( static bool   keyExistsWow64const String &)

The documentation for this class was generated from the following file: