mode: 對話框類型。參見：OPEN_FILE 等。默認(rèn)值：OPEN_FILE。
title: 對話框標(biāo)題。
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 的參數(shù)見 fileDialog，其中 mode 參數(shù)無效。

openMultipleFilesDialog(options)

打開一個文件多重選擇對話框。options 的參數(shù)見 fileDialog，其中 mode 參數(shù)無效。

saveFileDialog(options)

打開一個文件保存對話框。options 的參數(shù)見 fileDialog，其中 mode 參數(shù)無效。

openFolderDialog(options)

打開一個文件夾選擇對話框。options 的參數(shù)見 fileDialog，其中 mode 參數(shù)無效。

openNewFolderDialog(options)

打開一個新式的文件夾選擇對話框。options 的參數(shù)見 fileDialog，其中 mode 參數(shù)無效。僅適用于 Windows Vista 及以上系統(tǒng)。

OPEN_FILE

fileDialog 的 operations 參數(shù)。代表文件選擇對話框。

OPEN_MULTIPLE_FILES

fileDialog 的 operations 參數(shù)。代表文件多重選擇對話框。

OPEN_FOLDER

fileDialog 的 operations 參數(shù)。代表文件夾選擇對話框。

OPEN_NEW_FOLDER

fileDialog 的 operations 參數(shù)。代表新式的文件夾選擇對話框。

SAVE_FILE

fileDialog 的 operations 參數(shù)。代表文件夾保存對話框。

icon 擴(kuò)展

getIcon()

獲取當(dāng)前窗口的圖標(biāo)，返回值為一個對象，包含了 Uint8ClampedArray 類型的圖標(biāo)位圖數(shù)據(jù) array，字符串類型的 base64 uri，寬度及高度。

setIcon(array, [width, height])

將 array 中所指的位圖數(shù)據(jù)設(shè)置為當(dāng)前窗口的圖標(biāo)，若未指定 width 及 height 則默認(rèn)將圖標(biāo)理解為正方形。array 為 Uint8ClampedArray 類型，可以由 hex.snapshot()、hex.snapshotDesktop() 或者 canvas 元素獲得。

createIconFile(path, array, width, height)

將 array 中所指的位圖數(shù)據(jù)保存為 ico 文件，圖標(biāo)文件中包含一系列尺寸的圖標(biāo)。array 為 Uint8ClampedArray 類型，可以由 hex.snapshot()、hex.snapshotDesktop() 或者 canvas 元素獲得。

getFileIcon(path, [size])

獲取指定路徑 path 下的指定尺寸 [size] 的圖標(biāo)，返回值為 PNG 格式的 base64 字符串。若未指定 size 則默認(rèn)為 LARGE。

SMALL

代表 16x16 小圖標(biāo)，值為 0，搭配 getFileIcon() 使用。

NORMAL

代表 32x32 大圖標(biāo)，值為 1，搭配 getFileIcon() 使用。

LARGE

代表 48x48 (Linux) 或 32x32 (Windows) 大圖標(biāo)，值為 2，搭配 getFileIcon() 使用。

custom protocol 擴(kuò)展

create(protocol, path)

創(chuàng)建一個名為 protocol 的自定義協(xié)議類型，path 代表關(guān)聯(lián)的程序。創(chuàng)建成功返回 true，否則返回 false。

delete(protocol)

刪除 protocol 所指的自定義協(xié)議類型。刪除成功返回 true，否則返回 false。

registry 擴(kuò)展

registry 擴(kuò)展的功能都位于構(gòu)造器 Registry 上。

在使用 registry 擴(kuò)展之前，可以先了解一下 Windows 注冊表的相關(guān)內(nèi)容：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 注冊表中的鍵名不區(qū)分大小寫。

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

構(gòu)造一個 Registry 對象。共有 4 種構(gòu)造方式：

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 轉(zhuǎn)換成的 16 進(jìn)制的字符串。subkey 為要打開的子鍵的路徑，若為空則代表當(dāng)前主鍵。access 為可選，代表賦予的權(quán)限，參見 Registry Key Security and Access Rights。

當(dāng)所指的 Key 已存在則本操作執(zhí)行打開鍵 (OpenKey) 的動作，當(dāng)所指的 Key 不存在且 access_right 設(shè)置了允許創(chuàng)建新鍵，則本操作會執(zhí)行創(chuàng)建新鍵 (CreateKey) 的動作。本操作會在對象內(nèi)部保存一個系統(tǒng)的 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()

關(guān)閉一個打開的鍵，同時對象內(nèi)部保存的系統(tǒng)的 HKEY 也將會被清空。

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

在指定的鍵下創(chuàng)建子鍵，若 subkey 為空則代表當(dāng)前主鍵，若被創(chuàng)建的鍵已存在則打開它。

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

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

在當(dāng)前的鍵下創(chuàng)建子鍵，若 subkey 為空則代表當(dāng)前主鍵，若被創(chuàng)建的鍵已存在則打開它。

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

詳細(xì)信息請參見：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

詳細(xì)信息請參見：http://msdn.microsoft.com/en-us/library/windows/desktop/ms724836(v=vs.85).aspx

file association 擴(kuò)展

create(info)

創(chuàng)建一個自定義文件類型。info 是一個對象，包含以下信息：

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

關(guān)于 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'
});

← heX API 說明

heX 打包生成工具說明 →

寫筆記

我要補充

heX 擴(kuò)展說明

列表

sleep 擴(kuò)展列表

方法

shortcut 擴(kuò)展列表

方法

屬性

dialog 擴(kuò)展列表

方法

屬性

icon 擴(kuò)展列表

方法

屬性

custom protocol 擴(kuò)展列表

方法

registry 擴(kuò)展列表

方法

屬性

file association 擴(kuò)展列表

方法

sleep 擴(kuò)展

shortcut 擴(kuò)展

dialog 擴(kuò)展

icon 擴(kuò)展

custom protocol 擴(kuò)展

registry 擴(kuò)展

file association 擴(kuò)展