更新日志_MKScript脚本语言

MKScript 版本更新日志

2023-11-21MKScript 10.0

新增函数：
worksheet_copy()
worksheet_save_as()
workbook_save_copy_as()
workbooks_close()

函数定义更新

函数原定义	更新后
int workbook_save_as(int *workbookHandle, string filePath)	int workbook_save_as(int workbookHandle, string filePath [, int fileFormat] )

2023-10-28MKScript 9.9

新增函数：
atexit()

修复一个bug：folder_get_file_list()

#演示代码

ArrayList fileList

#调用函数 folder_get_file_list()
#当使用通配符例如 *.jpg 时, 如果在该文件夹中没找到相关类型的文件, 函数返回 0 而不是 1, 这是一个 bug
int status = folder_get_file_list("C:\\", fileList, "*.jpg")

println("status:" + status)

函数定义更新

函数原定义	更新后
int folder_get_file_list(string folderPath, ArrayList<string> list [, string extensionName])	int folder_get_file_list(string folderPath, ArrayList<string> list [, string extensionName] [, int isRecursionSubFolder])

2023-8-28MKScript 9.8

LinkedList 的数据结构由原来的【单向链表】修改为【双向链表】。
新增函数：
linkedlist_iterator_reverse()

color_hex_to_int()

screen_get_color_count()
screen_found_color_count()

clipboard_set_bmp()
clipboard_get_bmp()

函数定义更新

函数原定义	更新后
void alert(string t)	void alert(string t [, int timeout])
void mouse_wheel_down(int x, int y [, int times])	void mouse_wheel_down(int x, int y [, int times] [, int interval])
void mouse_wheel_up(int x, int y [, int times])	void mouse_wheel_up(int x, int y [, int times] [, int interval])
void window_mouse_wheel_down(int hWnd, int x, int y [, int fwKeys] [, int times])	void window_mouse_wheel_down(int hWnd, int x, int y [, int fwKeys] [, int times] [, int interval])
void window_mouse_wheel_up(int hWnd, int x, int y [, int fwKeys] [, int times])	void window_mouse_wheel_up(int hWnd, int x, int y [, int fwKeys] [, int times] [, int interval])

2023-5-19MKScript 9.7

新增关键词：include
新增函数：
get_short_path()
get_long_path()
get_full_path()
改进函数 folder_create()：支持创建最多64层子文件夹。
支持路径较长的文件与文件夹：之前文件与文件夹路径支持最长259个字符，现在支持最长32767个字符的路径。
注意：还有个别函数不支持长路径，比如 workbook_save_as()

删除 v8.1 过时的函数：

删除的函数

void mouse_click(int x, int y)

void mouse_click_right(int x, int y)

void mouse_click_double(int x, int y)

void mouse_press_left(int x, int y)

void mouse_press_right(int x, int y)

void mouse_release_left(int x, int y)

void mouse_release_right(int x, int y)

2023-5-6MKScript 9.6

新增函数：
base64_encode()
base64_encode_data()
base64_encode_file()
base64_decoded_size()
base64_decode()
base64_decode_to_byte_array()

json_parse()
json_print()
json_has_item()
json_get_item()
json_get_item_type()
json_is_false()
json_is_true()
json_is_null()
json_is_number()
json_is_string()
json_is_array()
json_is_object()
json_get_value_string()
json_get_value_int()
json_get_value_long()
json_get_value_double()
json_get_array_size()
json_get_array_item()
json_free()

weekday()
block_input()
console_print()
console_println()
修复自 MKScript 9.0+ 存在的一个bug：clipboard_set_text()

新增系统常量：

常量名	类型	值
mkJSON_False	int	1
mkJSON_True	int	2
mkJSON_NULL	int	4
mkJSON_Number	int	8
mkJSON_String	int	16
mkJSON_Array	int	32
mkJSON_Object	int	64
mkJSON_Raw	int	128

2023-3-30MKScript 9.5

新增函数：
bmp_get_bytes_len()
bmp_get_bytes()
bmp_read_data()
修复 bug：当在【循环体】内定义一个数组，同时其每一维的【䆟量】是一个变量或算术表达式，在访问数组时可能会出现运行时错误：索引越界。
```
#演示代码

for int i = 1 to 3
    
    int data[i]
    data[i - 1] = i
    
    println(data)

next
```

2023-3-16MKScript 9.3

当运行脚本过程中出现【运行时错误】时，提示当前执行脚本代码的行号，方便脚本调试。

2023-3-2MKScript 9.2

新增函数：
http_post()

window_get_item()
window_get_next_group_item()
window_get_next_tab_item()

函数 http_get() 新增可选参数 cookie 与 referer，同时支持 https 协议：

函数原定义	更新后
void http_get(string url, string *returnBody [, string fromCharset])	void http_get(string url, string *returnBody [, string fromCharset] [, string cookie] [, string referer])

新增系统常量：

常量名	类型	值
mkWM_COMMAND	int	0x0111
mkWM_CLOSE	int	0x0010
mkWM_DESTROY	int	0x0002

2023-2-18MKScript 9.1

新增支持字符串比较表达式

#演示代码

if "abc" > "123"

    println("字符串比较表达式")

endif

新增函数：
is_date()
string_to_date()

register_window_message()
make_copy_data()
free()

global_alloc_string()
global_alloc_byte_array()
global_size()
global_lock()
global_unlock()
global_free()

新增系统常量：

常量名	类型	值
mkGHND	int	0x0042
mkGMEM_FIXED	int	0x0000
mkGMEM_MOVEABLE	int	0x0002
mkGMEM_ZEROINIT	int	0x0040
mkGPTR	int	0x0040
mkWM_COPYDATA	int	0x004A

2023-2-1MKScript 9.0

新增函数：
key_left()
key_up()
key_right()
key_down()

len_byte()

MKScript 内部使用 wchar_t(宽字符) 替代 char(多字节字符) 重新实现字符(char)与字符串(string)类型，汉字中的一些生僻字现在可以在 MKScript 中正常使用。

#演示代码
	  
#注意：字符串处理相关函数在 v8.8- 与 v9.0 不同版本间表现有所不同

println("㐆斋文集") #汉字中的生僻字: 㐆

string t = "㐆斋文集"

#注意: v8.8- len(㐆斋文集):8
#注意: v9.0  len(㐆斋文集):4
println("len(㐆斋文集):" + len(t))

#len_byte(㐆斋文集):7
#len_byte(㐆斋文集, gbk):7
#len_byte(㐆斋文集, utf-8):12
println("len_byte(㐆斋文集):" + len_byte(t))
println("len_byte(㐆斋文集, gbk):" + len_byte(t, "gbk"))
println("len_byte(㐆斋文集, utf-8):" + len_byte(t, "utf-8"))

string t2 = "abc㐆斋文集"
int index = index_of(t2, "斋")

#注意: v8.8- index_of(): 5
#注意: v9.0  index_of(): 4
println("index_of():" + index)

支持在一行代码的尾部添加注释

#演示代码

int list[3] = {1, 2, 3} #支持在一行代码的尾部添加注释

println(list)

函数 input_box() 和 input_multiline_box() 支持输入多行文字描述。

删除函数：

删除的函数

int iconv(string fromCharset, string in, int inLen, string toCharset, string *out)

int gbk_to_utf8(string in_gbk, string *out_utf8)

int utf8_to_gbk(string in_utf8, string *out_gbk)

2022-11-8MKScript 8.8

新增函数：
file_copy()
修复自 MKScript 6.9+ 出现的关于解析【子函数定义的返回值类型与 return 返回的类型不一致】时存在的一个bug：
```
#下面的代码自 v6.9+ 解析时不会提示语法错误
```

2022-3-28MKScript 8.7

新增函数：
starts_with()
ends_with()
replace_first()

2022-3-8MKScript 8.6

函数 wait_mouse_left_down() 中的参数：x, y 变为可选参数。

函数原定义	更新后
void wait_mouse_left_down(int x, int y, [int isBlockMouseMessage])	void wait_mouse_left_down([int x, int y], [int isBlockMouseMessage])

2021-12-15MKScript 8.5

新增函数：
wait_mouse_left_down()
wait_key_press()

修复bug：当在子函数中调用一个未初始化值的【全局变量】时，弹出错误提示对话框。

#下面是bug验证代码：
	
#调用子函数
test()

#全局变量 v 定义在错误的位置：调用 test() 的代码下方
#int v = 123
string v = "abc"
#ArrayList<string> v
#LinkedList<string> v
#HashMap<string, string> v
#Iterator<int> v
#int v[3] = {1, 2, 3}
#Bmp v

#在子函数中输出全局变量 v 的值
func void test()
    println(v)
endfunc

2021-12-12MKScript 8.3

修复bug：当屏幕上显示透明属性的窗口时，屏幕取色相关函数，例如：screen_get_color_at() 现在可以准确的获取到颜色值。

2021-12-8MKScript 8.2

修复bug：当屏幕上显示透明属性的窗口时，屏幕找图相关函数，例如：screen_find_bmp() 现在可以准确的找到目标。

2021-11-12MKScript 8.1

新增左移与右移运算符：<<, >>
新增函数：
window_mouse_move_to()
window_mouse_left_click()
window_mouse_middle_click()
window_mouse_right_click()
window_mouse_double_click()
window_mouse_left_down()
window_mouse_left_up()
window_mouse_right_down()
window_mouse_right_up()
window_mouse_wheel_down()
window_mouse_wheel_up()

window_key_code()
window_key_press_code()
window_key_release_code()
window_input()

window_get_color_at()
window_get_bmp()
window_find_color()
window_find_bmp()

mkscript_window_initial_text()
mouse_middle_click()
bmp_file_write()
color_hex()
guid()

函数更名：

函数原名	更名为
void mouse_click(int x, int y)	void mouse_left_click(int x, int y)
void mouse_click_right(int x, int y)	void mouse_right_click(int x, int y)
void mouse_click_double(int x, int y)	void mouse_double_click(int x, int y)
void mouse_press_left(int x, int y)	void mouse_left_down(int x, int y)
void mouse_press_right(int x, int y)	void mouse_right_down(int x, int y)
void mouse_release_left(int x, int y)	void mouse_left_up(int x, int y)
void mouse_release_right(int x, int y)	void mouse_right_up(int x, int y)

新增系统常量：

常量名	类型	值
mkMK_LBUTTON	int	1
mkMK_RBUTTON	int	2
mkMK_SHIFT	int	4
mkMK_CONTROL	int	8
mkMK_MBUTTON	int	16
mkMK_XBUTTON1	int	32
mkMK_XBUTTON2	int	64

2021-8-9MKScript 8.0

新增对象：LinkedList<T>
新增函数：
linkedlist_add()
linkedlist_add_first()
linkedlist_insert()
linkedlist_index_of()
linkedlist_last_index_of()
linkedlist_contains()
linkedlist_remove()
linkedlist_remove_index()
linkedlist_remove_first()
linkedlist_remove_last()
linkedlist_set()
linkedlist_get()
linkedlist_get_first()
linkedlist_get_last()
linkedlist_iterator()
linkedlist_get_size()
linkedlist_clear()

file_open()
file_close()
file_eof()
file_rewind()
file_error()
file_clear_error()
file_get_last_error()
file_get_last_error_message()
file_get_error_message()
file_read_char()
file_write_char()
file_read_line()
file_write_text()
file_read_data()
file_write_data()
file_flush()

gbk_to_utf8()
utf8_to_gbk()
iconv()
byte_array_to_string()
string_to_byte_array()

get_error_message()

子函数的参数定义新增支持【静态数组】类型

#演示代码

#子函数：输出数组的值
func void printArr(int arr[], int count)

    for int i = 0 to count - 1

        println("arr[" + i + "]: " + arr[i])

    next

endfunc

int list[3] = {1, 2, 3}

printArr(list, 3)

修复bug：arraylist_last_index_of() 在 <T> = byte, char, short, int, float, long 时，返回的结果不准确。

#下面是bug验证代码：
ArrayList<int> list = {1, 2, 3, 5, 3, 9}

println("arraylist_index_of(list, 3):" + arraylist_index_of(list, 3))

#注意: arraylist_last_index_of() 返回值不准确
println("arraylist_last_index_of(list, 3):" + arraylist_last_index_of(list, 3))

函数定义更新

函数原定义更新后

string get_last_error_message([int errorID]) string get_last_error_message()
函数更名：

函数原名更名为

int window_mkscript_get_handle() int window_get_mkscript_handle()
删除(过时)的函数：

删除的函数

void iterator_jump_origin(Iterator<T> iterator)

void iterator_clear(Iterator<T> iterator)

2021-7-8MKScript 7.3

新增函数：
file_len()
file_rename()
file_delete()

folder_create()
folder_exist()
folder_rename()
folder_delete()
folder_get_subfolder_list()
folder_get_file_list()

labs()
fabs()
ldexp()
frexp()
modf()
fmod()

2021-5-26MKScript 7.2

新增函数：
input_box()
input_multiline_box()
file_dialog_show_open()
file_dialog_show_open_multi_select()
file_dialog_show_save()
folder_dialog_show()
函数 exit() 新增一个可选参数：status。

函数原定义更新后

int exit() int exit([int status])
修复一个bug：在没有调用 play_alert_sound() 时，调用 stop_alert_sound()，引发程序异常退出。
```
#下面是bug验证代码：
stop_alert_sound()
```

2021-5-13MKScript 7.1

新增函数：
arraylist_reset_capacity_factor()
hashmap_reset_capacity_factor()

函数 prompt() 新增一个可选参数：isPwdStyle，如果需要在弹出的输入对话框中输入密码，可将 isPwdStyle 设置为 1，输入的密码不可见。

函数原定义	更新后
int prompt(string text, string *value, [int type])	int prompt(string text, string *value, [int type], [int isPwdStyle])

修复 v7.0 中出现的一个bug：当脚本运行到弹出一个提示对话框时，用户按下【停止】快捷键后，出现无法关闭窗口的情况。
```
#下面是bug验证代码：
alert("hello")
```

2021-4-8MKScript 7.0

新增函数：
sin()
cos()
tan()
sinh()
cosh()
tanh()
asin()
acos()
atan()
atan2()
exp()
log()
log10()
pow()
sqrt()

mouse_get_cursor_style()

hardware_get_cpu_logical_number()
改进找图算法，提升性能。下面列出与找图相关的四个函数分别新增了一个可选参数：int threadCount，用于开启多线程找图：
screen_find_bmp()
screen_find_bmp_from_area()

bmp_find_bmp()
bmp_find_bmp_from_area()

弃用(过时)的函数：

弃用的函数	替代方案
mouse_get_cursor_at(int x, int y)	mouse_get_cursor_style(int x, int y)
mouse_cursor_is_hand_at(int x, int y)	mouse_get_cursor_style(x, y) == mkMouse_HAND

2021-3-21MKScript 6.9

新增 for [T] var in (静态数组 | 动态数组) 循环语句

#静态数组
int arr[5] = {1,2,3,4,5}
println("遍历静态数组：")
for int v in arr
    println(v)
next

#换行
println("")

#动态数组
ArrayList<string> list = {"one", "two", "three"}
arraylist_add(list, "four")
arraylist_add(list, "five")

println("遍历动态数组：")
for string t in list
    println(t)
next

函数定义更新：函数 run() 的后三个参数由必填更改为可选参数

函数原定义	更新后
int run(string filePath, string parameters, string directory, int nShowCmd)	int run(string filePath, [string parameters], [string directory], [int nShowCmd])

修复三维静态数组的bug： v6.8- 之前的所有版本对三维静态数组的赋值和读取全都存在问题。

#下面是bug验证代码

int arr[3][4][5] = {{{1,2,3}}, {{7,8,9}}}

println("arr[0][0][0]:" + arr[0][0][0])

println("arr[2][0][0]:" + arr[2][0][0])

arr[2][0][0] = 99
println("arr[2][0][0]:" + arr[2][0][0])

println("arr[0][0][0]:" + arr[0][0][0])

2021-3-10MKScript 6.8

新增函数：
run()
com_object_get_function() 参数支持以 "a.b.func" 结构描述对象的方法，映射COM对象的方法时更方便。
com_object_get_xxx(), com_object_set_xxx() 参数支持以 "a.b.prop" 结构描述对象的属性，设置或读取COM对象的属性时更方便。
修复解析【逻辑表达式】时存在的一个bug：
```
#下面的代码使用 v6.7- 解析时会报语法错误
```

2021-1-26MKScript 6.7

脚本中如涉及到文件读写、调用第三方DLL、调用COM组件对象时不再弹出权限确认对话框。
新增函数：
worksheet_get_row_height()
worksheet_get_column_width()
worksheet_set_row_height()
worksheet_set_column_width()
worksheet_get_range_row_height()
worksheet_get_range_column_width()
worksheet_set_range_row_height()
worksheet_set_range_column_width()

2020-12-10MKScript 6.6

改进 com_object_get_xxx()、worksheet_get_range_value_xxx()、worksheet_get_cell_value_xxx() ，在函数返回值时实现对数据类型的自动转换。
float、double 类型的数在与字符串进行算术运算或通过println()输出时，自动删除小数结尾多余的0：
```
float x = 3.14
println(x)
println("x:" + x)
```
v6.6 输出的结果：
3.14
x:3.14

v6.5 输出的结果：
3.140000
x:3.140000

2020-11-12MKScript 6.5

新增十六进制数字表示法，前缀 0x 开头：0xff
新增函数：
time_s()
date()
date_add()
date_diff_s()
variant_time_to_unix_time()
unix_time_to_variant_time()

com_object_get_type()
com_object_get_type_name()
com_object_get_date()
com_object_set_date()

connection_open()
connection_execute()
connection_close()

recordset_get_short()
recordset_get_type()
recordset_get_type_name()

excel_get_version()
excel_display_alert()
excel_show_window()
excel_hide_window()
excel_get_workbooks()
excel_get_active_workbook()
excel_get_active_worksheet()
excel_quit()

workbooks_get_count()
workbooks_get_index()
workbooks_add()
workbooks_open()

workbook_get_worksheets()
workbook_save_as()
workbook_save()
workbook_close()

worksheets_get_count()
worksheets_add()
worksheets_get_index()
worksheets_get_item()
worksheets_select_index()
worksheets_select_item()

worksheet_get_name()
worksheet_set_name()
worksheet_select()
worksheet_delete()
worksheet_get_range_value_type()
worksheet_get_range_value_type_name()
worksheet_get_range_value_boolean()
worksheet_get_range_value_int()
worksheet_get_range_value_long()
worksheet_get_range_value_double()
worksheet_get_range_value_currency()
worksheet_get_range_value_date()
worksheet_get_range_value_string()
worksheet_get_cell_value_type()
worksheet_get_cell_value_type_name()
worksheet_get_cell_value_boolean()
worksheet_get_cell_value_int()
worksheet_get_cell_value_long()
worksheet_get_cell_value_double()
worksheet_get_cell_value_currency()
worksheet_get_cell_value_date()
worksheet_get_cell_value_string()
worksheet_set_range_value_boolean()
worksheet_set_range_value_int()
worksheet_set_range_value_long()
worksheet_set_range_value_double()
worksheet_set_range_value_currency()
worksheet_set_range_value_date()
worksheet_set_range_value_string()
worksheet_set_range_color()
worksheet_set_range_color_index()
worksheet_set_range_font_style()
worksheet_set_range_font_name()
worksheet_set_range_font_size()
worksheet_set_cell_value_boolean()
worksheet_set_cell_value_int()
worksheet_set_cell_value_long()
worksheet_set_cell_value_double()
worksheet_set_cell_value_currency()
worksheet_set_cell_value_date()
worksheet_set_cell_value_string()
worksheet_set_cell_color()
worksheet_set_cell_color_index()
worksheet_set_cell_font_style()
worksheet_set_cell_font_name()
worksheet_set_cell_font_size()

函数定义更新：修复2038年时间问题。

函数原定义	更新后
int time()	double time([int year, int month, int day, int hour, int minute, int second])
int year([int t])	int year([double t])
int month([int t])	int month([double t])
int day([int t])	int day([double t])
int hour([int t])	int hour([double t])
int minute([int t])	int minute([double t])
int second([int t])	int second([double t])
string get_date([int t])	string get_date([double t])
string get_time([int t])	string get_time([double t])
string get_date_time([int t])	string get_date_time([double t])

int recordset_get_date(int *recordsetHandle, string fieldName)	double recordset_get_date(int *recordsetHandle, string fieldName)

新增系统常量：

常量名	类型	值
mkSecond	int	1
mkMinute	int	2
mkHour	int	3
mkDay	int	4
mkMonth	int	5
mkYear	int	6

mkVT_Empty	int	0
mkVT_Null	int	1
mkVT_Short	int	2
mkVT_Int	int	3
mkVT_Float	int	4
mkVT_Double	int	5
mkVT_Currency	int	6
mkVT_Date	int	7
mkVT_String	int	8
mkVT_Object	int	9
mkVT_Error	int	10
mkVT_Boolean	int	11
mkVT_Variant	int	12
mkVT_Unknown	int	13
mkVT_Decimal	int	14
mkVT_Char	int	16
mkVT_Byte	int	17
mkVT_Long	int	20
mkVT_Array	int	8192

2020-9-22MKScript 6.3

改进COM组件对象的处理方式，可以通过调用 Excel.Application 对象来操作Excel工作表。

2020-8-11MKScript 6.2

新增函数：
register_hotkey()
unregister_hotkey()

新增系统常量：

常量名	类型	值
mkMOD_ALT	int	1
mkMOD_CONTROL	int	2
mkMOD_SHIFT	int	4

2020-7-30MKScript 6.1

新增函数：
mkscript_config_auto_start()
hex()
get_cmd_argv()
get_date_time()
set_current_directory()
get_current_directory()
get_mkscript_folder_path()
get_script_folder_path()
get_system_folder_path()

storage_set_domain()
storage_remove()
storage_clear()

com_initialize()
com_uninitialize()

com_object_set_byte()
com_object_set_char()
com_object_set_short()
com_object_set_boolean()
com_object_set_object()

com_object_set_safe_array_byte()
com_object_set_safe_array_char()
com_object_set_safe_array_short()
com_object_set_safe_array_int()
com_object_set_safe_array_long()
com_object_set_safe_array_float()
com_object_set_safe_array_double()
com_object_set_safe_array_string()

com_object_get_byte()
com_object_get_char()
com_object_get_short()
com_object_get_boolean()
com_object_get_object()

com_object_get_array_length()
com_object_get_array_byte()
com_object_get_array_char()
com_object_get_array_short()
com_object_get_array_int()
com_object_get_array_long()
com_object_get_array_float()
com_object_get_array_double()
com_object_get_array_string()

com_safe_array_new_byte()
com_safe_array_new_char()
com_safe_array_new_short()
com_safe_array_new_int()
com_safe_array_new_long()
com_safe_array_new_float()
com_safe_array_new_double()
com_safe_array_new_string()
com_safe_array_destroy()

recordset_get_boolean()
recordset_get_int()
recordset_get_long()
recordset_get_date()
recordset_get_float()
recordset_get_double()
recordset_get_string()

recordset_bof()
recordset_eof()
recordset_move_next()
recordset_get_count()
recordset_close()

函数定义更新：日期时间类函数新增可选参数 int t

函数原定义	更新后
int year()	int year([int t])
int month()	int month([int t])
int day()	int day([int t])
int hour()	int hour([int t])
int minute()	int minute([int t])
int second()	int second([int t])
string get_date()	string get_date([int t])
string get_time()	string get_time([int t])

函数更名：所有【预处理函数】的名称全部更改为以 mkscript_ 开头

函数原名	更名为
hotkey_pause_or_continue_ctrl_alt_char()	mkscript_hotkey_pause_or_continue_ctrl_alt_char()
hotkey_pause_or_continue_ctrl_char()	mkscript_hotkey_pause_or_continue_ctrl_char()
hotkey_pause_or_continue_shift_char()	mkscript_hotkey_pause_or_continue_shift_char()
hotkey_pause_or_continue_alt_char()	mkscript_hotkey_pause_or_continue_alt_char()
hotkey_pause_or_continue_code()	mkscript_hotkey_pause_or_continue_code()

hotkey_stop_ctrl_alt_char()	mkscript_hotkey_stop_ctrl_alt_char()
hotkey_stop_ctrl_char()	mkscript_hotkey_stop_ctrl_char()
hotkey_stop_shift_char()	mkscript_hotkey_stop_shift_char()
hotkey_stop_alt_char()	mkscript_hotkey_stop_alt_char()
hotkey_stop_code()	mkscript_hotkey_stop_code()

window_mkscript_initial_size()	mkscript_window_initial_size()
window_mkscript_initial_position()	mkscript_window_initial_position()

COM 函数指针定义中，关于函数参数类型的定义新增语法修饰符：*!，比如 byte *! 表示这个参数是一个 COM 安全数组类型：

int comID = com_object_new("adodb.stream")

#函数指针定义
void (*write)(byte *!) = com_object_get_function(comID, "write")

#定义一个 byte 静态数组
byte bytes[10] = {60,33,68,79,67,84,89,80,69,32}

#由 byte 静态数组生成 COM 安全数组
int safeArrayID = com_safe_array_new_byte(bytes, 10)

#调用 COM 对象中的 write() 方法
write(safeArrayID)

新增系统常量：

常量名	类型	值
mkCOINIT_APARTMENTTHREADED	int	2
mkCOINIT_MULTITHREADED	int	0
mkCOINIT_DISABLE_OLE1DDE	int	4
mkCOINIT_SPEED_OVER_MEMORY	int	8

mkCSIDL_DESKTOP	int	0
mkCSIDL_APPDATA	int	26
mkCSIDL_COMMON_APPDATA	int	35
mkCSIDL_COMMON_DESKTOPDIRECTORY	int	25
mkCSIDL_COMMON_DOCUMENTS	int	46
mkCSIDL_COMMON_PICTURES	int	54
mkCSIDL_COMMON_TEMPLATES	int	45
mkCSIDL_DESKTOPDIRECTORY	int	16
mkCSIDL_LOCAL_APPDATA	int	28
mkCSIDL_MYPICTURES	int	39
mkCSIDL_SYSTEM	int	37
mkCSIDL_TEMPLATES	int	21
mkCSIDL_SYSTEMX86	int	41
mkCSIDL_PERSONAL	int	5
mkCSIDL_MYDOCUMENTS	int	5

2020-4-13MKScript 6.0

修改MKScript脚本默认的【启动/暂停】键为：F2，默认的【停止键】：F8
MKScript代码辅助工具：新增【静态定位取色】快捷键，同时【放大镜】的底部增加了文本区域用于显示鼠标当前坐标和颜色值。

2020-2-23MKScript 5.3

新增关键词：goto
修复bug：
1. 脚本解析bug，相关验证代码：
```
string t = split("a,b,c", ",")
```
2. 修复v5.2版脚本运行时使用未定义变量但没有报错的问题，相关验证代码如下：
```
if 1 == 2
    int x = 3
endif

println(x)
```
MKScript代码辅助工具：新增【静态定位取色】功能。

2019-12-2MKScript 5.2

新增函数：
window_get_desktop()
window_redraw()

time_ms()

get_dc()
create_compatible_dc()
create_compatible_bitmap()
select_object()
create_pen()
create_solid_brush()
get_stock_object()
delete_object()
delete_dc()
release_dc()
bit_blt()
rgb()
rv()
gv()
bv()
set_pixel()
set_pixel_v()
get_pixel()
line()
rectangle()
fill_rect()
round_rect()
ellipse()
arc()
pie()
chord()
draw_bmp()
invalidate_rect()

函数更名：

函数原名	更名为
void select_text(int x, int y, int x2, int y2)	void mouse_select_text(int x, int y, int x2, int y2)
void select_object(int x, int y, int x2, int y2)	void mouse_select_object(int x, int y, int x2, int y2)

新增系统常量：

常量名	类型	值
mkPS_SOLID	int	0
mkPS_DASH	int	1
mkPS_DOT	int	2
mkPS_DASHDOT	int	3
mkPS_DASHDOTDOT	int	4
mkPS_NULL	int	5
mkPS_INSIDEFRAME	int	6

mkBLACK_BRUSH	int	4
mkDKGRAY_BRUSH	int	3
mkDC_BRUSH	int	18
mkGRAY_BRUSH	int	2
mkHOLLOW_BRUSH	int	5
mkLTGRAY_BRUSH	int	1
mkNULL_BRUSH	int	5
mkWHITE_BRUSH	int	0

mkBLACK_PEN	int	7
mkDC_PEN	int	19
mkNULL_PEN	int	8
mkWHITE_PEN	int	6

mkBLACKNESS	int	66
mkCAPTUREBLT	int	1073741824
mkDSTINVERT	int	5570569
mkMERGECOPY	int	12583114
mkMERGEPAINT	int	12255782
mkNOMIRRORBITMAP	int	2147483648
mkNOTSRCCOPY	int	3342344
mkNOTSRCERASE	int	1114278
mkPATCOPY	int	15728673
mkPATINVERT	int	5898313
mkPATPAINT	int	16452105
mkSRCAND	int	8913094
mkSRCCOPY	int	13369376
mkSRCERASE	int	4457256
mkSRCINVERT	int	6684742
mkSRCPAINT	int	15597702
mkWHITENESS	int	16711778

mkRDW_ERASE	int	4
mkRDW_FRAME	int	1024
mkRDW_INTERNALPAINT	int	2
mkRDW_INVALIDATE	int	1
mkRDW_NOERASE	int	32
mkRDW_NOFRAME	int	2048
mkRDW_NOINTERNALPAINT		16
mkRDW_VALIDATE	int	8
mkRDW_ERASENOW	int	512
mkRDW_UPDATENOW	int	256
mkRDW_ALLCHILDREN	int	128
mkRDW_NOCHILDREN	int	64

2019-10-9MKScript 5.1

新增算术运算符：& | ^ ~
新增函数：
config_paused_show_alert()
config_stopped_show_alert()
config_ended_show_alert()

window_enable()

window_set_position()
window_set_active()
window_set_foreground()
window_set_focus()
window_set_pos()
window_set_text()
window_set_button_checked()
window_set_combo_box_selected_index()
window_set_combo_box_selected_text()

window_get()
window_get_window_rect()
window_get_client_rect()
window_get_size()
window_get_position_on_screen()
window_get_active()
window_get_foreground()
window_get_focus()
window_get_from_point()
window_get_child_list()
window_get_top_level_list()
window_get_combo_box_selected_index()
window_get_parent()
window_get_id()
window_get_class_name()
window_get_text()

window_is_iconic()
window_is_zoomed()
window_is_visible()
window_is_enabled()
window_is_button_checked()

window_screen_to_client()
window_client_to_screen()

window_find()
window_find_ex()

window_send_message()
window_send_message_timeout()
window_post_message()

make_wparam()
make_lparam()
修复v5.0一个严重的bug
如果使用一个返回值类型为 string 的函数做为比较表达式的一部分时，结果与预期不符：
```
if lcase("ABC") == "abc"
    println("两者相同")
endif
```

函数定义更新：

函数原定义	更新后
int window_show()	int window_show(int windowHandle, int cmdShow)
int window_top(int status)	int window_top(int windowHandle, int status)

函数更名：

函数原名	更名为
int window_set_size(int width, int height)	int window_mkscript_initial_size(int width, int height)
int window_set_location(int x, int y)	int window_mkscript_initial_position(int x, int y)
int window_get_handle()	int window_mkscript_get_handle()

弃用(过时)的函数：

弃用的函数	替代方案
window_minimize()	window_show(window_mkscript_get_handle(), mkSW_MINIMIZE)
window_hide()	window_show(window_mkscript_get_handle(), mkSW_HIDE)

新增系统常量：

常量名	类型	值
mkNull	int	0

mkSW_FORCEMINIMIZE	int	11
mkSW_HIDE	int	0
mkSW_MAXIMIZE	int	3
mkSW_MINIMIZE	int	6
mkSW_RESTORE	int	9
mkSW_SHOW	int	5
mkSW_SHOWDEFAULT	int	10
mkSW_SHOWMAXIMIZED	int	3
mkSW_SHOWMINIMIZED	int	2
mkSW_SHOWMINNOACTIVE	int	7
mkSW_SHOWNA	int	8
mkSW_SHOWNOACTIVATE	int	4
mkSW_SHOWNORMAL	int	1

mkHWND_BOTTOM	int	1
mkHWND_NOTOPMOST	int	-2
mkHWND_TOP	int	0
mkHWND_TOPMOST	int	-1
mkHWND_MESSAGE	int	-3
mkHWND_BROADCAST	int	65535

mkSWP_ASYNCWINDOWPOS	int	16384
mkSWP_DEFERERASE	int	8192
mkSWP_DRAWFRAME	int	32
mkSWP_FRAMECHANGED	int	32
mkSWP_HIDEWINDOW	int	128
mkSWP_NOACTIVATE	int	16
mkSWP_NOCOPYBITS	int	256
mkSWP_NOMOVE	int	2
mkSWP_NOOWNERZORDER	int	512
mkSWP_NOREDRAW	int	8
mkSWP_NOREPOSITION	int	512
mkSWP_NOSENDCHANGING	int	1024
mkSWP_NOSIZE	int	1
mkSWP_NOZORDER	int	4
mkSWP_SHOWWINDOW	int	64

mkGW_CHILD	int	5
mkGW_ENABLEDPOPUP	int	6
mkGW_HWNDFIRST	int	0
mkGW_HWNDLAST	int	1
mkGW_HWNDNEXT	int	2
mkGW_HWNDPREV	int	3
mkGW_OWNER	int	4

mkBST_CHECKED	int	1
mkBST_INDETERMINATE	int	2
mkBST_UNCHECKED	int	0

mkSMTO_ABORTIFHUNG	int	2
mkSMTO_BLOCK	int	1
mkSMTO_NORMAL	int	0
mkSMTO_NOTIMEOUTIFNOTHUNG	int	8
mkSMTO_ERRORONEXIT	int	32

2019-9-10MKScript 5.0

新增【子函数】支持，新增关键词：func, endfunc, return 用于子函数定义，例如：
```
func int Max(int a, int b)
    if a > b
        return a
    else
        return b
    endif
endfunc
```
新增调用【DLL动态链接库】和【COM组件对象】功能
新增关键词： byte, short, long, float, void
byte, short, long, float, void 新增的这几个数据类型主要为了调用DLL动态链接库以及COM接口函数时的数据类型匹配。
void 还用于子函数类型定义和函数指针类型定义，例如函数指针定义：void (*func)(int, int*) = dll_get_function("xxx")
新增函数：
dll_load()
dll_get_function()
dll_free()

com_object_new()
com_object_new_by_iid()
com_object_get_function()
com_object_set_int()
com_object_set_long()
com_object_set_float()
com_object_set_double()
com_object_set_string()
com_object_get_int()
com_object_get_long()
com_object_get_float()
com_object_get_double()
com_object_get_string()
com_object_free()
hotkey_pause_or_continue_ctrl_char()
hotkey_pause_or_continue_shift_char()
hotkey_pause_or_continue_alt_char()
hotkey_pause_or_continue_code()

hotkey_stop_ctrl_char()
hotkey_stop_shift_char()
hotkey_stop_alt_char()
hotkey_stop_code()

screen_get_physical_width()
screen_get_physical_height()

screen_get_logical_width()
screen_get_logical_height()

screen_get_resolution_x_scale()
screen_get_resolution_y_scale()

screen_position_physical_to_logical()
screen_position_logical_to_physical()

stof()
stol()
itof()
itol()
ltoi()
ltof()
ltod()
ltos()
ftoi()
ftol()
ftod()
ftos()
dtof()
dtol()

space()

window_get_handle()

mouse_get_position()

stop_alert_sound()
修复bug：screen_find_bmp_from_area() 与 bmp_find_bmp_from_area()

函数定义更新：新增可选参数 [similarity], 用于寻找相似图片

函数原定义	更新后
int screen_find_bmp(Bmp bmp, int returnX, int returnY)	int screen_find_bmp(Bmp bmp, int returnX, int returnY [, double similarity])
int screen_find_bmp_from_area(int x, int y, int width, int height, Bmp bmp, int returnX, int returnY)	int screen_find_bmp(int x, int y, int width, int height, Bmp bmp, int returnX, int returnY [, double similarity])
int bmp_find_bmp(Bmp b1, Bmp b2, int returnX, int returnY)	int bmp_find_bmp(Bmp b1, Bmp b2, int returnX, int returnY [, double similarity])
int bmp_find_bmp_from_area(Bmp b1, int x, int y, int width, int height, Bmp b2, int returnX, int returnY)	int bmp_find_bmp_from_area(Bmp b1, int x, int y, int width, int height, Bmp b2, int returnX, int returnY [, double similarity])

新增系统常量：

常量名	类型	值
mkVK_Back	int	8
mkVK_Tab	int	9
mkVK_Clear	int	12
mkVK_Enter	int	13
mkVK_Shift	int	16
mkVK_Ctrl	int	17
mkVK_Alt	int	18
mkVK_CapsLock	int	20
mkVK_Esc	int	27
mkVK_Space	int	32
mkVK_PageUp	int	33
mkVK_PageDown	int	34
mkVK_End	int	35
mkVK_Home	int	36
mkVK_Left	int	37
mkVK_Up	int	38
mkVK_Right	int	39
mkVK_Down	int	40
mkVK_Snapshot	int	44
mkVK_Insert	int	45
mkVK_Delete	int	46
mkVK_Win	int	91
mkVK_F1	int	112
mkVK_F2	int	113
mkVK_F3	int	114
mkVK_F4	int	115
mkVK_F5	int	116
mkVK_F6	int	117
mkVK_F7	int	118
mkVK_F8	int	119
mkVK_F9	int	120
mkVK_F10	int	121
mkVK_F11	int	122
mkVK_F12	int	123

2019-7-22MKScript 3.8

新增对象：HashMap<K, V> 与 Iterator<T>
新增函数：
key_press_win()
key_release_win()
key_tab()
key_alt_char()
key_alt_code()
key_ctrl_alt_char()
key_ctrl_alt_code()
key_alt_shift_char()
key_alt_shift_code()
key_win_char()
key_win_code()

hashmap_put()
hashmap_get()
hashmap_contains_key()
hashmap_contains_value()
hashmap_remove()
hashmap_get_size()
hashmap_clear()
hashmap_keys()
hashmap_values()

iterator_has_next()
iterator_next()
iterator_jump_origin()
iterator_clear()

函数定义更新：

函数原定义	更新后
void key_windows()	void key_win()
void key_windows_d()	void key_win_d()

void key_back_space(int times)	void key_back_space([int times])
void key_space(int times)	void key_space([int times])
void key_enter(int times)	void key_enter([int times])
void key_page_down(int times)	void key_page_down([int times])
void key_page_up(int times)	void key_page_up([int times])
void mouse_wheel_down(int times)	void mouse_wheel_down([int times])
void mouse_wheel_up(int times)	void mouse_wheel_up([int times])

2019-5-15MKScript 3.7

新增函数：
file_exist()
file_write()
get_last_error()
get_last_error_message()
修复bug：
1. window_set_location()
2. 修复在 win 10, dpi > 100% 时的鼠标定位问题

函数定义更新：

函数原定义	更新后
int file_read(string filePath, string charset, string body)	int file_read(string filePath, string body [, string charset])

2019-1-21MKScript 3.6

新增函数：
http_get()
url_encode()
storage_set()
storage_get()
md5()
hardware_get_cpu()
hardware_get_mac()
修复bug：
prompt()
screen_get_desktop_height()

2018-12-14MKScript 3.5

新增函数：
bmp_find_bmp_from_area()
bmp_find_bmp()
bmp_clone()
bmp_reset()
clipboard_set_text()
clipboard_get_text()
window_top()
confirm()
prompt()
is_int()
is_numeric()
pause()

新增系统常量：

常量名	类型	值
mkTrue	int	1
mkFalse	int	0

mkOk	int	1
mkCancel	int	2
mkYes	int	6
mkNo	int	7

mkOkCancel	int	1
mkYesNo	int	4
mkYesNoCancel	int	3

mkMouse_ARROW	int	65539
mkMouse_IBEAM	int	65541
mkMouse_WAIT	int	65543
mkMouse_CROSS	int	65545
mkMouse_UPARROW	int	65547
mkMouse_SIZENWSE	int	65549
mkMouse_SIZENESW	int	65551
mkMouse_SIZEWE	int	65553
mkMouse_SIZENS	int	65555
mkMouse_SIZEALL	int	65557
mkMouse_NO	int	65559
mkMouse_APPSTARTING	int	65561
mkMouse_HELP	int	65563
mkMouse_HAND	int	65567

mkPrompt_String	int	0
mkPrompt_Char	int	1
mkPrompt_Int	int	2
mkPrompt_Numeric	int	3

mkCr	string	"\r"
mkLf	string	"\n"
mkCrLf	string	"\r\n"

函数定义更新：

函数原定义	更新后
string file_read(string filePath, string charset, int status)	int file_read(string filePath, string charset, string body)

exit() 函数调用后，将直接退出，不再弹出提示对话框。

2018-11-21MKScript 3.3

新增位图对象 Bmp
新增函数：
screen_find_color()
screen_find_color_from_area()
screen_get_bmp()
screen_bmp_equal()
screen_find_bmp()
screen_find_bmp_from_area()
screen_get_dpi()
bmp_file_read()
bmp_get_width()
bmp_get_height()
bmp_get_bit_count()
bmp_get_len()
bmp_equal()
window_show()
window_hide()

函数更名：

v3.2 原函数名	v3.3 更名为
set_window_size	window_set_size
set_window_location	window_set_location
minimize_window	window_minimize
get_color_at	screen_get_color_at
get_color_for_mouse_over_at	screen_get_color_for_mouse_over_at
get_screen_colors	screen_get_colors
get_screen_width	screen_get_width
get_screen_height	screen_get_height
get_full_screen_width	screen_get_desktop_width
get_full_screen_height	screen_get_desktop_height

重构 screen_get_colors() 和 screen_colors_equal()，提升性能。
重构变量的全局性逻辑。

2018-04-23MKScript 3.2

重写了【静态数组】的实现，改进了数据结构，减少了运行时的内存占用。重构了变量赋值的实现，提升脚本性能。
新增函数: get_screen_colors(), screen_colors_equals(), set_window_location(), minimize_window(), version()。
改进函数: input()，新增可选参数：delay, 解决在【浏览器地址栏】或常用【搜索框】中输入大量中英文字符时可能会出现输入的字符不完整情况。
改进解析脚本时的错误提示，在大部分情况下如果解析脚本时出现函数的参数类型错误，相关错误提示会精确到函数的第几个参数类型错误，方便代码调试。

2018-04-09MKScript 3.1

if 语句新增关键词： elseif
新增逻辑运算符：&&(与) ||(或)
新增鼠标操作相关函数: mouse_get_cursor_at(x, y) 和 mouse_cursor_is_hand_at(x, y)

2018-03-18MKScript 3.0

新增 for 循环语句: for i = 1 to 5 ... next
新增静态数组的支持: int a[3] = {1,2,3}, int b[3][3] = {{1,2,3}, {7,8,9}}, string list[5] = {"a", "b", "c"}
新增动态数组的支持: ArrayList<int> list = {1,2,3}, ArrayList<string> list2 = {"a", "b", "c"}
新增日期时间相关的函数：time(), year(), month()... second(), get_now(), get_date(), get_time()
新增字符串处理函数: len(), index_of(), last_index_of(), mid(), replace(), trim(), char_at() ... split()
新增数学函数: abs(), round(), randomize(), rnd()
新增文件操作相关函数： file_read()
新增类型转换函数: stoi(), stod(), itos(), itod(), dtoi(), dtos()
新增动态数组操作函数: arraylist_add(), arraylist_insert(), arraylist_get(), ... arraylist_clear()
改进 print() 和 println() 函数, 支持输出多种格式的数据: println(3), println(3.14), println("abc")

2018-02-27MKScript 2.0

新增支持带返回值的函数调用，例如: int screenWidth = get_screen_width()
内置了几个常用的函数：get_screen_width(), get_screen_height(), get_color_at(x,y), get_color_for_mouse_over_at(x,y) 等。
由于支持带返回值的函数调用，所以从 2.0 版开始取消了关键词： if_color_at, 替代方案：if get_color_at(x,y) == color

2018-02-07MKScript 1.0

2018-01-16MKScript 项目创建

函数原定义	更新后
string get_last_error_message([int errorID])	string get_last_error_message()