heX 扩展说明

mode: 对话框类型。参见：OPEN_FILE 等。默认值：OPEN_FILE。
title: 对话框标题。
defaultFileName: 对话框的缺省文件名或路径。
acceptTypes: 对话框所支持的文件类型。此选项为一个对象，key 代表类型描述，value 代表类型过滤器（如 *.*，*.png 等，多种过滤器用分号隔开）。

Example:

fileDialog({
    "mode": hex.OPEN_FILE,
    "title": "Select an image",
    "defaultFileName": "d:\\",
    "acceptTypes": {
        "Image files": "*.bmp;*.gif;*.jpg;*.png",
        "All files": "*.*"
    }
})

openFileDialog(options)

打开一个文件选择对话框。options 的参数见 fileDialog，其中 mode 参数无效。

openMultipleFilesDialog(options)

打开一个文件多重选择对话框。options 的参数见 fileDialog，其中 mode 参数无效。

saveFileDialog(options)

打开一个文件保存对话框。options 的参数见 fileDialog，其中 mode 参数无效。

openFolderDialog(options)

打开一个文件夹选择对话框。options 的参数见 fileDialog，其中 mode 参数无效。

openNewFolderDialog(options)

打开一个新式的文件夹选择对话框。options 的参数见 fileDialog，其中 mode 参数无效。仅适用于 Windows Vista 及以上系统。

OPEN_FILE

fileDialog 的 operations 参数。代表文件选择对话框。

OPEN_MULTIPLE_FILES

fileDialog 的 operations 参数。代表文件多重选择对话框。

OPEN_FOLDER

fileDialog 的 operations 参数。代表文件夹选择对话框。

OPEN_NEW_FOLDER

fileDialog 的 operations 参数。代表新式的文件夹选择对话框。

SAVE_FILE

fileDialog 的 operations 参数。代表文件夹保存对话框。

icon 扩展

getIcon()

获取当前窗口的图标，返回值为一个对象，包含了 Uint8ClampedArray 类型的图标位图数据 array，字符串类型的 base64 uri，宽度及高度。

setIcon(array, [width, height])

将 array 中所指的位图数据设置为当前窗口的图标，若未指定 width 及 height 则默认将图标理解为正方形。array 为 Uint8ClampedArray 类型，可以由 hex.snapshot()、hex.snapshotDesktop() 或者 canvas 元素获得。

createIconFile(path, array, width, height)

将 array 中所指的位图数据保存为 ico 文件，图标文件中包含一系列尺寸的图标。array 为 Uint8ClampedArray 类型，可以由 hex.snapshot()、hex.snapshotDesktop() 或者 canvas 元素获得。

getFileIcon(path, [size])

获取指定路径 path 下的指定尺寸 [size] 的图标，返回值为 PNG 格式的 base64 字符串。若未指定 size 则默认为 LARGE。

SMALL

代表 16x16 小图标，值为 0，搭配 getFileIcon() 使用。

NORMAL

代表 32x32 大图标，值为 1，搭配 getFileIcon() 使用。

LARGE

代表 48x48 (Linux) 或 32x32 (Windows) 大图标，值为 2，搭配 getFileIcon() 使用。

custom protocol 扩展

create(protocol, path)

创建一个名为 protocol 的自定义协议类型，path 代表关联的程序。创建成功返回 true，否则返回 false。

has(protocol)

返回是否存在 protocol 所指的自定义协议类型。

delete(protocol)

删除 protocol 所指的自定义协议类型。删除成功返回 true，否则返回 false。

registry 扩展

registry 扩展的功能都位于构造器 Registry 上。

在使用 registry 扩展之前，可以先了解一下 Windows 注册表的相关内容：http://technet.microsoft.com/en-us/library/a1377b7d-277f-47ba-adde-96ee781be5b3 及 http://msdn.microsoft.com/en-us/library/windows/desktop/ms724871(v=vs.85).aspx

Windows 注册表中的键名不区分大小写。

new Registry([handle, [subkey, [access]]])

构造一个 Registry 对象。共有 4 种构造方式：

new Registry(handle)
new Registry(handle_hex_string)
new Registry(handle, subkey, [access])
new Registry(handle_hex_string, subkey, [access])

handle 为一个注册表键 (Key) 的句柄 (handle)，即 HKEY，handle_hex_string 为 handle 转换成的 16 进制的字符串。subkey 为要打开的子键的路径，若为空则代表当前主键。access 为可选，代表赋予的权限，参见 Registry Key Security and Access Rights。

当所指的 Key 已存在则本操作执行打开键 (OpenKey) 的动作，当所指的 Key 不存在且 access_right 设置了允许创建新键，则本操作会执行创建新键 (CreateKey) 的动作。本操作会在对象内部保存一个系统的 HKEY。

如打开 0x80000000 代表的键，即 HKEY_CLASSES_ROOT：

var Registry = hex.extensions.hex_registry_extension.Registry;
var reg = new Registry('0x80000000');

var Registry = hex.extensions.hex_registry_extension.Registry;
var reg = new Registry('0x80000000', 'SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\Fonts', Reg.KEY_READ);

Registry.prototype.close()

关闭一个打开的键，同时对象内部保存的系统的 HKEY 也将会被清空。

Registry.prototype.create(handle, subkey, [access])

在指定的键下创建子键，若 subkey 为空则代表当前主键，若被创建的键已存在则打开它。

var Registry = hex.extensions.hex_registry_extension.Registry;
var reg = new Registry('0x80000000');
reg.create(Reg.HKEY_CLASSES_ROOT, '*');

Registry.prototype.createKey(subkey, [access])

在当前的键下创建子键，若 subkey 为空则代表当前主键，若被创建的键已存在则打开它。

var Registry = hex.extensions.hex_registry_extension.Registry;
var reg = new Registry(Reg.HKEY_CLASSES_ROOT);
reg.create('*', Reg.KEY_ALL_ACCESS);

var Registry = hex.extensions.hex_registry_extension.Registry;
var reg = new Registry(Reg.HKEY_CLASSES_ROOT);
reg.set(Reg.HKEY_CURRENT_USER);

var Registry = hex.extensions.hex_registry_extension.Registry;
var reg = Reg.createFromReservedKey(Reg.HKEY_CLASSES_ROOT);
var reg = Reg.createFromReservedKey(‘HKEY_CLASSES_ROOT’);
var reg = new Registry(Reg.HKEY_CLASSES_ROOT);
// 上面三行等效

Registry.KEY_QUERY_VALUE
Registry.KEY_SET_VALUE
Registry.KEY_CREATE_SUB_KEY
Registry.KEY_ENUMERATE_SUB_KEYS
Registry.KEY_NOTIFY
Registry.KEY_CREATE_LINK
Registry.KEY_WOW64_32KEY
Registry.KEY_WOW64_64KEY
Registry.KEY_WOW64_RES
Registry.KEY_READ
Registry.KEY_WRITE
Registry.KEY_EXECUTE
Registry.KEY_ALL_ACCESS

详细信息请参见：http://msdn.microsoft.com/en-us/library/windows/desktop/ms724878(v=vs.85).aspx

Predefined Keys

Registry.HKEY_CLASSES_ROOT
Registry.HKEY_CURRENT_USER
Registry.HKEY_LOCAL_MACHINE
Registry.KEY_ENUMERATE_SUB_KEYS
Registry.HKEY_USERS
Registry.HKEY_PERFORMANCE_DATA
Registry.HKEY_PERFORMANCE_TEXT
Registry.HKEY_PERFORMANCE_NLSTEXT
Registry.HKEY_CURRENT_CONFIG
Registry.HKEY_DYN_DATA
Registry.HKEY_CURRENT_USER_LOCAL_SETTINGS

详细信息请参见：http://msdn.microsoft.com/en-us/library/windows/desktop/ms724836(v=vs.85).aspx

file association 扩展

create(info)

创建一个自定义文件类型。info 是一个对象，包含以下信息：

extension
prog_id
description
content_type
perceived_type
icon_path
icon_index
open_command
open_command_arguments
clsid
cur_ver
friendly_type_name

关于 Windows 文件类型注册，请参见：http://msdn.microsoft.com/en-us/library/windows/desktop/cc144104(v=vs.85).aspx

var FA = hex.extensions.hex_file_association_extension;
FA.create({
  extension: 'test',
  prog_id: 'My.Test',
  description: 'My test file type',
  icon_path: process.execPath,
  icon_index: 0,
  open_command: process.execPath,
  open_command_arguments: '%1'
});

USING HTML5 AND NODE.JSTO BUILD DESKTOP APPLICATION