APL Wiki|
Size: 565
Comment:
|
Size: 2662
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 2: | Line 2: |
| {{{WinReg}}} is part of the CategoryAplTree project. | |
| Line 3: | Line 4: |
| [[TableOfContents]] | <<TableOfContents>> |
| Line 6: | Line 7: |
'''Currently under construction''' |
|
| Line 11: | Line 9: |
| Find out more by looking into the documentation [attachment:WinRegDocumentation.html] | == Terminology == To understand the names of the methods you need to understand the terminology. If you find the terminology strange: so do I, but it was invented by Microsoft and got widely accepted. That is the reason why I decided to go for it: it makes it easier to understand others while talking about the Windows Registry. In this picture: [[attachment:EditReg.jpg|{{attachment:EditReg.jpg|attachment:EditReg.jpg}}]] you can see this string: {{{HKEY_CURRENT_USER\Software\Dyalog\Dyalog APL/W 12.0 Unicode\AutoComplete}}} at the top of the window. === HKEY_CURRENT_USER === This is called a "Main key". There are a number of pre-defined main keys available you can choose from. For the most important one from an application programmers view there is also a shortcut available: instead of '''HKEY_CURRENT_USER''' you can use '''HKCU'''. === SOFTWARE\Dyalog\Dyalog APL/W 12.0 Unicode === This is called a '''sub key'''. On the right side you see a list. The entries in this list are called "values". Therefore '''!CancelKey1''' is a value. Note that the ''names'' are called values! The actual data saved under a value is called "data". == Shared Methods == {{{ Close CopyTree DeleteSubKey DeleteSubKeyTree DeleteValue DoesKeyExist DoesValueExist Close CopyTree Copyright DeleteSubKey DeleteSubKeyTree DeleteValue DoesKeyExist DoesValueExist GetAllSubKeyNames GetAllValueNames GetAllValues GetDyalogRegPath GetErrorAsStringFrom GetString GetTree GetTreeWithValues GetTypeAsStringFrom GetValue History KeyInfo ListError ListReg OpenAndCreateKey OpenKey PutBinary PutString PutValue ReadByte }}} == Restrictions == Note the following restrictions: * `PutValue` supports DWORDs (REG_DWORD) * `PutBinary` supports REG_BINARY * `PutString` and `GetString` support strings (REG_SZ), nested strings (REG_MULTI_SZ) and expanded strings (REG_EXPAND_SZ) * `GetValue` supports all data types. Other data types can be requested via `GetValue`; however, writing them is not supported. == Project Page == For bug reports, future enhancements and a full version history see WinReg/ProjectPage |
| Line 14: | Line 87: |
| ||Original author: ||KaiJaeger || ||Responsible: ||KaiJaeger || ||Email: || kai@aplteam.com || |
|
| Line 15: | Line 91: |
| ||Original author:||KaiJaeger|| ||Responsible:||KaiJaeger|| ||Email:||kai@aplteam.com|| ||Current state:||1.0|| == Download == Goto the [:WinRegDownloadPage:WinRegDownloadPage] |
<<Include(APLTreeDownloads)>> |
| Line 24: | Line 94: |
| CategoryOpenSourceApl CategoryAplAplDyalog | CategoryAplTree |
Dealing with the Windows Registry
WinReg is part of the CategoryAplTree project.
Contents
Overview
This class offers methods useful to deal with the Windows Registry without using .NET.
Terminology
To understand the names of the methods you need to understand the terminology. If you find the terminology strange: so do I, but it was invented by Microsoft and got widely accepted. That is the reason why I decided to go for it: it makes it easier to understand others while talking about the Windows Registry.
In this picture:
you can see this string:
HKEY_CURRENT_USER\Software\Dyalog\Dyalog APL/W 12.0 Unicode\AutoComplete
at the top of the window.
HKEY_CURRENT_USER
This is called a "Main key". There are a number of pre-defined main keys available you can choose from. For the most important one from an application programmers view there is also a shortcut available: instead of HKEY_CURRENT_USER you can use HKCU.
SOFTWARE\Dyalog\Dyalog APL/W 12.0 Unicode
This is called a sub key.
On the right side you see a list. The entries in this list are called "values". Therefore CancelKey1 is a value.
Note that the names are called values! The actual data saved under a value is called "data".
Shared Methods
Close CopyTree DeleteSubKey DeleteSubKeyTree DeleteValue DoesKeyExist DoesValueExist Close CopyTree Copyright DeleteSubKey DeleteSubKeyTree DeleteValue DoesKeyExist DoesValueExist GetAllSubKeyNames GetAllValueNames GetAllValues GetDyalogRegPath GetErrorAsStringFrom GetString GetTree GetTreeWithValues GetTypeAsStringFrom GetValue History KeyInfo ListError ListReg OpenAndCreateKey OpenKey PutBinary PutString PutValue ReadByte
Restrictions
Note the following restrictions:
PutValue supports DWORDs (REG_DWORD)
PutBinary supports REG_BINARY
PutString and GetString support strings (REG_SZ), nested strings (REG_MULTI_SZ) and expanded strings (REG_EXPAND_SZ)
GetValue supports all data types.
Other data types can be requested via GetValue; however, writing them is not supported.
Project Page
For bug reports, future enhancements and a full version history see WinReg/ProjectPage
Version Information
Original author: |
|
Responsible: |
|
Email: |