Registry object

 

 

Registry global object.
This object is specific to Windows platforms.

Syntax

A Registry global object is created for you and only this object can exist in the application. It is named Registry and is globally accessible.

Parameters

none.

Property Of

global name space.

Implemented In

ECMerge 2.1

Description

 The Registry object let you access registry variables.

Properties

none. 

Methods

get_value
get_values_list
get_subkeys_list

Examples

see functions samples.

See Also 

 none.

Method get_value

Syntax

function get_value (key_path, value_name)
returns String, Integer or undefined.

Parameters

key_path. String. Path to a Windows registry key.
value_name. String. Name of the value to read

Method Of

Registry object

Implemented In

ECMerge 2.1

Description

Returns the value of the value with given value_name under key at key_path. The returned value is numeric if the value is a DWORD value,  it is a String otherwise. If the key or value is not found, undefined is returned.

Examples

Example 1.

Shows message box with the location where Ellié Computing Merge was installed:

alert ( Registry.get_value ("HKEY_LOCAL_MACHINE\\SOFTWARE\\Ellié Computing\\Merge", "Path") );

See Also 

 Registry object.

 

Method get_values_list / get_subkeys_list

Syntax

function get_values_list (key_path, re)
function get_subkeys_list (key_path, re)
returns Array of Strings or null.

Parameters

key_path. String. Path to a Windows registry key.
re. RegExp object. Regular expression which must be matched for a value or subkey name to be returned. If omitted, all the values or subkey names are returned.

Method Of

Registry object.

Implemented In

ECMerge 2.1

Description

Both functions return null if the key is not found.
get_values_list returns an Array of the names of the values located in the given key.
get_subkeys_list returns an Array of the names of the subkeys located in the given key.

Examples

Example 1.

Lists the values in Ellié Computing Merge registry key:

var values_array = Registry.get_values_list ("HKEY_LOCAL_MACHINE\\SOFTWARE\\Ellié Computing\\Merge");
if (values_array)
    alert ( values_array.join(", ") );
else
    alert ("ECMerge is not yet installed !");

See Also 

 Registry object.