MKScript 版本更新日志

• 新增关键词：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)

• 新增函数：
  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

• 新增函数：
  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

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

• 新增函数：
  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

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

  #演示代码
  
  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

• 新增函数：
  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)

• 新增函数：
  file_copy()
• 修复自 MKScript 6.9+ 出现的关于解析【子函数定义的返回值类型与 return 返回的类型不一致】时存在的一个bug：
  

  #下面的代码自 v6.9+ 解析时不会提示语法错误

  
  

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

• 函数 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])

• 新增函数：
  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

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

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

• 新增左移与右移运算符：<<, >>
• 新增函数：
  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

• 新增对象：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)

• 新增函数：
  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()

• 新增函数：
  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()

• 新增函数：
  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")

• 新增函数：
  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

• 新增 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])

• 新增函数：
  run()
  
• com_object_get_function() 参数支持以 "a.b.func" 结构描述对象的方法，映射COM对象的方法时更方便。
• com_object_get_xxx(), com_object_set_xxx() 参数支持以 "a.b.prop" 结构描述对象的属性，设置或读取COM对象的属性时更方便。
• 修复解析【逻辑表达式】时存在的一个bug：
  

  #下面的代码使用 v6.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()
  

• 改进 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

• 新增十六进制数字表示法，前缀 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

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

• 新增函数：
  register_hotkey()
  unregister_hotkey()
  
• 新增系统常量：
  

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

• 新增函数：
  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

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

• 新增关键词：goto
• 修复bug：
  1. 脚本解析bug，相关验证代码：

  string t = split("a,b,c", ",")

  2. 修复v5.2版脚本运行时使用未定义变量但没有报错的问题，相关验证代码如下：

  if 1 == 2
      int x = 3
  endif
  
  println(x)

• MKScript代码辅助工具： 新增【静态定位取色】功能。
  

• 新增函数：
  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

• 新增算术运算符：& | ^ ~
  
• 新增函数：
  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

• 新增【子函数】支持，新增关键词：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

• 新增对象：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])

• 新增函数：
  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])

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

• 新增函数：
  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() 函数调用后，将直接退出，不再弹出提示对话框。

• 新增位图对象 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()，提升性能。
• 重构变量的全局性逻辑。

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

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

• 新增 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")

• 新增支持带返回值的函数调用，例如: 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