vk：快捷键的虚拟键码
subFuncName：子函数的名称，注意：在这里子函数的名称不能加括号 ()

特别说明：在脚本代码执行结束后，才会响应用户按下的快捷键。

#示例：注册快捷键
		  
#预处理函数: 设置脚本加载后自动启动
mkscript_config_auto_start()

#子函数
func void f1()

    println("按了 F1")

    #在这时可以通过编写脚本, 实现按下一个键完成多个动作
    #mouse_move_to(100, 100)
    #mouse_left_click(100, 100)

endfunc

#子函数
func void f3()

    println("按了 F3 或 Ctrl + Q ")

    #在这时可以通过编写脚本, 实现按下一个键完成多个动作

    #在这里演示鼠标的移动
    int i
    for i = 1 to 9
        mouse_move_to(i * 100, i * 100)
        sleep(100)
    next

endfunc

#注册快捷键
println("注册快捷键: F1, 调用 f1() 子函数")
register_hotkey(0, mkVK_F1, "f1")
println("注册快捷键: F3, 调用 f3() 子函数")
register_hotkey(0, mkVK_F3, "f3")

println("注册快捷键: CTRL + Q, 调用 f3() 子函数")

#注意：这里的 Q 必须是大写字母
register_hotkey(mkMOD_CONTROL, 'Q', "f3")

注意：鼠标移动、点击等操作所使用的坐标是屏幕【逻辑分辨率】下的坐标。

#示例：

#获取当前屏幕分辨率x,y轴的缩放比例, 针对屏幕可能使用高 DPI 情况
double x_scale = screen_get_resolution_x_scale()
double y_scale = screen_get_resolution_y_scale()
println("x_scale:" + x_scale + ", y_scale:" + y_scale)

#鼠标移动到屏幕坐标位置(300, 200)
mouse_move_to(300 / x_scale, 200 / y_scale)

#暂停3秒
sleep(3000)

#在屏幕坐标位置(600, 500) 点击鼠标左键
mouse_left_click(600 / x_scale, 500 / y_scale)

注意：鼠标移动、点击等操作所使用的坐标是屏幕【逻辑分辨率】下的坐标。

#示例：

#获取当前屏幕分辨率x,y轴的缩放比例, 针对屏幕可能使用高 DPI 情况
double x_scale = screen_get_resolution_x_scale()
double y_scale = screen_get_resolution_y_scale()
println("x_scale:" + x_scale + ", y_scale:" + y_scale)

#窗口句柄
int hwnd = ...

#向后台窗口(hwnd)发送消息：鼠标点击右键，在坐标位置(300, 200)
window_mouse_right_click(hwnd, 300 / x_scale, 200 / y_scale)

#暂停3秒
sleep(3000)

参数：
x：屏幕x坐标
y：屏幕y坐标
width：搜索区域的宽
height：搜索区域的高
color_rule：颜色匹配规则， 格式为"RRGGBB-DRDGDB"，例如"123456-000000|aabbcc-202020"。也支持反色模式。前面加 ^ 即可。比如"^123456-000000|aabbcc-202020"
反色模式是指匹配任意一个指定颜色之外的颜色。比如"^123456|333333"。在匹配时，会匹配除了123456和333333之外的所有颜色。
similarity：可选参数，模糊搜索，取值范围(0.01 - 1.0), 其中 1.0 表示颜色值需完全匹配

参数：
x：屏幕x坐标
y：屏幕y坐标
width：搜索区域的宽
height：搜索区域的高
color_rule：颜色匹配规则， 格式为"RRGGBB-DRDGDB"，例如"123456-000000|aabbcc-202020"。也支持反色模式。前面加 ^ 即可。比如"^123456-000000|aabbcc-202020"
反色模式是指匹配任意一个指定颜色之外的颜色。比如"^123456|333333"。在匹配时，会匹配除了123456和333333之外的所有颜色。
count：需要搜索到符合颜色规则的像素数量
similarity：可选参数，模糊搜索，取值范围(0.01 - 1.0), 其中 1.0 表示颜色值需完全匹配

返回字符串的字节长度。

参数：
text：一个字符串。
charset：可选参数(utf-8 或 gbk)，使用指定的字符集将字符串编码为字节序列，并返回字节长度。

对Base64字符串进行解码。

参数：
base64Text：已编码的Base64字符串。
sourceText：一个字符串变量名，存储解码后的内容。
fromCharset：可选项(utf-8 或 gbk)，可以对解码后的字符串按指定字符集进行转换，然后存储到sourceText。

返回值：

对Base64字符串进行解码，并将解码后的数据存放到 data 字节数组中。

参数：
base64Text：已编码的Base64字符串。
data：存储解码后的字节数组
count：字节数组的长度

返回值：

返回值：

星期日：1，星期一：2，星期二：3，...，星期六：7

如果成功注册消息，则返回值是范围0xC000到0xFFFF的消息标识符。

如果函数失败，则返回值为零。

返回值：成功调用返回一个文件句柄。失败返回 0

获取指定的系统文件夹路径。

函数原型(Windows API)： SHGetSpecialFolderPath()

CSIDL_ID：标识代号，参数值可查看：系统常量

#示例：

HashMap<int, string> map

hashmap_put(map, 1, "one")
hashmap_put(map, 2, "two")
hashmap_put(map, 3, "three")

Iterator<int> iKeys = hashmap_keys(map)
loop iterator_has_next(iKeys) == mkTrue
    println("key:" + iterator_next(iKeys))
endloop

println("")

Iterator<string> iValues = hashmap_values(map)
loop iterator_has_next(iValues) == mkTrue
    println("value:" + iterator_next(iValues))
endloop

inthttp_post(string url, string data, string *returnBody [, string fromCharset] [, string cookie] [, string referer])

#示例：

#设置当前的存储【域】
int status = storage_set_domain("my_app_name")

status = storage_set("user", "test")
if status == 1
    storage_set("age", "16")
    println("user:" + storage_get("user"))

    #将string(字符串)转换成int(整数)
    int age = stoi(storage_get("age"))

    if age >= 16
        println("age:" + age)
    endif
endif

#演示在 MKScript 中调用 Win32 API 函数

#加载 user32.dll
int dllHandle = dll_load("user32.dll")

#MessageBoxW 函数功能: 显示一个模式对话框，其中包含系统图标、一组按钮和一条简短的应用程序特定消息，例如状态或错误信息。
#消息框返回一个整数值，该值指示用户单击的按钮。
#详细说明： https://learn.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-messageboxw

#定义【函数指针: mb】映射到【MessageBoxW 函数】
int (*mb)(int, string, string, int) = dll_get_function("MessageBoxW")

#消息框中显示的按钮, 指定以下值之一
int MB_OK          = 0x00000000 #消息框包含一个按钮： 确定。 这是默认值。
int MB_OKCANCEL    = 0x00000001 #消息框包含两个推送按钮： “确定 ”和 “取消”。
int MB_YESNOCANCEL = 0x00000003 #消息框包含三个按钮： 是、 否和 取消。
int MB_YESNO       = 0x00000004 #消息框包含两个按下按钮： 是 和 否。
int MB_RETRYCANCEL = 0x00000005 #消息框包含两个按下按钮： 重试 和 取消。

#消息框中显示图标, 指定以下值之一
int MB_ICONERROR       = 0x00000010 #消息框中会显示一个停止符号图标。
int MB_ICONQUESTION    = 0x00000020 #消息框中会显示一个问号图标。
int MB_ICONWARNING     = 0x00000030 #消息框中会显示一个感叹号图标
int MB_ICONINFORMATION = 0x00000040 #图标由圆圈中的小写字母 i 组成，显示在消息框中。

#调用 mb() 相当于调用了 Win32 API 函数：MessageBoxW()
int status = mb(window_get_mkscript_handle(), "看到一个弹出对话框了吗？", "这是标题", MB_YESNO | MB_ICONQUESTION)

#返回值	        说明
#----------------------------------
# 1             已选择【确定】按钮。
# 2             已选择【取消】按钮。
# 4             已选择【重试】按钮。
# 6             已选择【是】按钮。
# 7             已选择【否】按钮。
println("status:" + status)

获取COM对象的属性值的类型，返回值可以是以下常量值：

comObjectHandle：COM对象句柄。
propertyName：属性名

#演示【大漠插件】在 MKScript 中的使用

int ret
int hwnd

#自定义标签
start:

#初始化大漠插件的对象: dm.dmsoft
int comId = com_object_new("dm.dmsoft")
println("comId:" + comId)

if comId == 0

    alert("大漠插件还没有注册")
        
    #暂停脚本
    pause(mkFalse)
    
    #跳转到标签: start 处开始运行
    goto start

endif

#函数指针: 将大漠插件对象的"方法"转换为 MKScript 的函数
string (*dm_ver)() = com_object_get_function(comId, "Ver")
int (*dm_set_path)(string) = com_object_get_function(comId, "SetPath")
int (*dm_bind_window)(int, string, string, string, int) = com_object_get_function(comId, "BindWindow")    
int (*dm_unbind_window)() = com_object_get_function(comId, "UnBindWindow")
int (*dm_capture)(int, int, int, int, string) = com_object_get_function(comId, "Capture")
int (*dm_key_down_char)(string) = com_object_get_function(comId, "KeyDownChar")
int (*dm_key_up_char)(string) = com_object_get_function(comId, "KeyUpChar")

println("大漠版本:" + dm_ver())

#设置目录
#ret = dm_set_path("F:\\大漠插件V3.1233")
#println("dm_set_path():" + ret)

#查找窗口
hwnd = window_find("", "窗口的标题栏")

if hwnd == 0

    alert("未找到窗口，请先确认指定的窗口是否显示")
    
    #暂停脚本
    pause(mkFalse)
    
    #跳转到标签: start 处开始运行
    goto start
    
endif

#先绑定窗口为后台模式
ret = dm_bind_window(hwnd, "dx2", "dx", "dx", 0)
println("dm_bind_window():" + ret)

#截图，注意：窗口不能最小化!!!
#测试时发现: 有的时候截图是一片空白图, 解决方案说是要把上面 dm_bind_window() 参数 dx2 改成 dx3 
#ret = dm_capture(0, 0, 1300, 1300, "screen.bmp")
#println("dm_capture():" + ret)

#【后台键盘】：按下 'F' 键
ret = dm_key_down_char("F")
println("dm_key_down_char():" + ret)

#【后台键盘】：松开 'F' 键
ret = dm_key_up_char("F")
println("dm_key_up_char():" + ret)   

#取消绑定后台窗口
ret = dm_unbind_window()
println("dm_unbind_window():" + ret)

println("测试完毕")

#暂停
pause(mkFalse)

goto start

保存指定工作簿对象(Workbook)到一个文件。
workbookHandle：工作簿对象(Workbook)句柄。
filePath：文件路径
fileFormat：可选参数，采用指定格式保存文件。可选值请参考这里

返回值：1(成功), 0(失败)

将对工作表对象(Worksheet)的更改保存到另一不同文件中。
worksheetHandle：工作表对象(Worksheet)句柄。
filePath：文件路径
fileFormat：可选参数，采用指定格式保存文件。可选值请参考这里

返回值：1(成功), 0(失败)

如果函数成功，则返回值是指定窗口的客户区DC的句柄。
如果函数失败，则返回值为0。

注意：
使用公共DC绘画后，必须调用 release_dc() 函数以释放DC。

创建具有指定设备兼容的内存设备上下文(DC)。

函数原型(Windows API)： CreateCompatibleDC()

参数：
hdc：现有DC的句柄。如果此句柄为0，则该函数将创建一个与应用程序当前屏幕兼容的内存DC。

返回值：
如果函数成功，则返回值是内存DC的句柄。
如果函数失败，则返回值为0。

在以下情况下，系统将取消阻止输入：

如果内存对象在递减锁计数后仍处于锁定状态，则返回值为非零值。 如果内存对象在递减锁计数后解锁，则函数返回零， get_last_error() 返回0。

如果函数失败，则返回值为零，get_last_error() 返回除0以外的值。

如果函数成功，则返回值为 NULL。
如果函数失败，则返回值等于全局内存对象的句柄。

在 MKScript 脚本运行过程中，执行到 exit() 函数或用户关闭 MKScript 窗口时，按后进先出的顺序调用 func_name()。

该函数的效果类似于ANSI 标准函数：atexit()