运算符
变量和常量之间采用运算符连接后，称为表达式。MQ语言支持的运算符包括：
|
运算符
|
含义
|
|
+
|
加法运算
|
|
-
|
二元运算符：减法
一元运算符：负号
|
|
*
|
乘法运算
|
|
/
|
除法运算
|
|
Mod
|
整除取余
|
|
^
|
取幂
|
|
&
|
字符串连接
|
|
=
|
赋值
例如：当一个语句为X=Y时
|
|
等于（当用于表达式内部时）
|
|
|
<>
|
不等于
|
|
>
|
大于
|
|
<
|
小于
|
|
>=
|
大于等于
|
|
<=
|
小于等于
|
|
Not
|
逻辑非
|
|
And
|
逻辑与
|
|
Or
|
逻辑或
|
基本语句
MQ的基本语句如下：
注意！以下标红为按键精灵（安卓版）新增的相关命令语句，包含部分有改动的语句
|
名称
|
格式
|
解释
|
|
If
|
If 表达式 Then
…
ElseIf 表达式 Then
…
Else
…
End If
|
判断表达式并执行语句－－通过判断表达式的取值，来执行后面的动作或控制。
|
|
Else
|
If 表达式 Then
…
ElseIf 表达式 Then
…
Else
…
End If
|
和If语句结合，进行条件判断。
|
|
ElseIf
|
If 表达式 Then
…
ElseIf 表达式 Then
…
ElseIf 表达式 Then
…
Else
…
End If
|
和If语句结合，进行条件判断。
|
|
Then
|
If 表达式 Then
|
和If、ElseIf语句结合，进行条件判断。
|
|
While
|
While 循环条件
…
Wend
|
循环语句－－当循环条件成立的时候，反复执行循环体。
|
|
Wend
|
While 循环条件
…
Wend
|
和While一起构成循环语句。
|
|
For
|
For 循环次数
或
For 变量 = 起始数值 To 终止数值
或
For 变量 = 起始数值 To 终止数值 Step 步长数值
或
For Each 变量 In 数组
...
Next
|
循环语句。可以循环一定次数，也可以按照变量的起始数值到终止数值循环（如果不指定步长数值，默认步长为1），也可以循环取得数组中的所有值。
|
|
Next
|
Next
|
和For一起构成循环语句。
|
|
Select
|
Select Case 表达式
Case 情况1
…
Case 情况2
…
Case Else
…
End Select
|
根据情况选择条件判断。
|
|
Case
|
Select Case 表达式
Case 情况1
…
Case 情况2
…
Case Else
…
End Select
|
根据情况选择条件判断。
|
|
Do
|
Do While 表达式
…
Loop
或者
Do Until 表达式
…
Loop
|
条件循环
|
|
Loop
|
Do While 表达式
…
Loop
或者
Do Until 表达式
…
Loop
|
条件循环
|
|
Until
|
Do Until 表达式
…
Loop
|
条件循环
|
|
Sub
|
Sub 过程名(参数1, 参数2, ...)
…
End Sub
|
定义一个过程，可以在脚本中调用这个过程。
|
|
Function
|
Function 函数过程名(参数1, 参数2, ...)
…
End Function
|
定义一个函数过程，可以在脚本中调用这个函数。
|
|
Call
|
Call 函数或者过程名
(参数1, 参数2, ...)
可以简写为
函数或者过程名参数1, 参数2, ...
（省略Call关键字，并且无括号）
|
调用函数或者过程。
|
|
End If
|
End If
|
用于配对结束 If 条件判断。
|
|
End Select
|
End Select
|
用于配对结束 Select Case 选择情况判断。
|
|
End Sub
|
[End Sub
|
用于配对结束 Sub 子程序过程。
|
|
End Function
|
End Function
|
用于配对结束 Function 函数过程。
|
|
Exit Do
|
Exit Do
|
用于配对退出 Do 循环。
|
|
Exit For
|
Exit For
|
用于配对退出 For 循环。
|
|
Exit Sub
|
Exit Sub
|
用于配对退出 Sub 子程序过程。
|
|
Exit Function
|
Exit Function
|
用于配对退出 Function 函数过程。
|
|
EndScript
|
EndScript
|
强制结束脚本的执行。
|
|
Dim
|
Dim 变量1, 变量2 ...
|
定义一个或多个变量。
|
内置命令
MQ语言中已经包含了下列名称的子程序（也称为内置命令），在脚本中可以随时调用。
|
名称
|
格式
|
解释
|
|||||||||||||||||||||
|
Abs
|
Abs（数值表达式）
|
返回数值的绝对值，绝对值是其无符号的数值大小。例如，Abs(-1) 和 Abs(1) 都返回 1。
|
|||||||||||||||||||||
|
Asc
|
Asc（字符串表达式）
|
返回与字符串的第一个字母对应的字符ASCII码。
|
|||||||||||||||||||||
|
Atn
|
Atn（数值表达式）
|
返回数值的反正切值。
即计算直角三角形两个边的比值 (number) 并返回对应角的弧度值。此比值是该角对边的长度与邻边长度之比。结果的范围是从 -pi/2 到 pi/2 弧度。
将角度乘以 pi/180 即可转换为弧度，将弧度乘以 180/pi 即可转换为角度。
|
|||||||||||||||||||||
|
CBool
|
CBool（表达式）
|
试图把表达式转换为Bool类型并返回此Bool值。
|
|||||||||||||||||||||
|
CDbl
|
CDbl（表达式）
|
试图把表达式转换为数值类型并返回此数值。
|
|||||||||||||||||||||
|
Chr
|
Chr（数值表达式）
|
返回与指定的ASCII字符代码相对应的字符。
|
|||||||||||||||||||||
|
CInt
|
CInt（表达式）
|
试图把表达式转换为数值类型，并返回此数值经过四舍五入的结果。
|
|||||||||||||||||||||
|
CLng
|
CLng（表达式）
|
试图把表达式转换为数值类型，并返回此数值经过四舍五入的结果。
|
|||||||||||||||||||||
|
Sin
|
Sin(数值表达式)
|
返回将某个角表示为弧度数值的正弦值。即取某个角并返回直角三角形两边的比值。此比值是直角三角形中该角的对边长度与斜边长度之比。
结果范围在 -1 到 1 之间。
将角度乘以 pi/180 即可转换为弧度，将弧度乘以 180/pi 即可转换为角度。
|
|||||||||||||||||||||
|
Cos
|
Cos（数值表达式）
|
返回将某个角表示为弧度数值的余弦值。
即取某个角并返回直角三角形两边的比值。此比值是直角三角形中该角的邻边长度与斜边长度之比。结果范围在 -1 到 1 之间。
将角度乘以 pi/180 即可转换为弧度，将弧度乘以 180/pi 即可转换为角度。
|
|||||||||||||||||||||
|
CSng
|
CSng（表达式）
|
试图把表达式转换为数值类型并返回此数值。
|
|||||||||||||||||||||
|
CStr
|
CStr（表达式）
|
试图把表达式转换为字符串类型并返回此字符串。
|
|||||||||||||||||||||
|
Date
|
Date（时间表达式）
|
返回当前系统日期。格式为年/月/日，如2013年10月1日表示为2013/10/01。
|
|||||||||||||||||||||
|
Exp
|
Exp（数值表达式）
|
返回 e（自然对数的底）的幂次方。常数e约为 2.718282。
|
|||||||||||||||||||||
|
Fix
|
Fix（数值表达式）
|
返回指定数值的整数部分。
如果指定的数值为负数时，Fix会返回大于或等于该数值的第一个负整数。例如，Fix将 -8.4 转换为 -8。
|
|||||||||||||||||||||
|
Hex
|
Hex（数值表达式）
|
返回表示十六进制数值的字符串。当指定的数值表达式包含小数位时，会先采用四舍五入的方式去掉小数位再转换。
|
|||||||||||||||||||||
|
InStr
|
InStr(起始位置, 字符串1, 字符串2)
|
返回字符串2在字符串1中第一次出现的位置，从字符串1的某个指定起始位置开始搜索。
起始位置为数值表达式，用于设置每次搜索的开始位置，设为0表示从头开始搜索。
|
|||||||||||||||||||||
|
InStrRev
|
InStrRev
(字符串1, 字符串2, 起始位置)
|
返回字符串2在字符串1中出现的从结尾计起的位置。从字符串1的某个指定起始位置开始逆向搜索。
起始位置为数值表达式，用于设置每次搜索的开始位置，设为-1，表示从最后一个字符的位置开始搜索。
|
|||||||||||||||||||||
|
Int
|
Int(数值表达式)
|
返回指定数值的整数部分。如果指定的数值为负数时，Int会返回小于或等于该数值的第一个负整数。
|
|||||||||||||||||||||
|
IsArray
|
IsArray（变量）
|
返回 Bool 值指明某变量是否为数组。如果变量是数组，IsArray 返回 True；否则，返回 False。
|
|||||||||||||||||||||
|
IsNull
|
IsNull（变量）
|
返回 Bool 值，指明某变量是否不包含任何有效数据 (Null)。未初始化的变量通常都不包含任何有效数据。
|
|||||||||||||||||||||
|
IsNumeric
|
IsNumeric（变量）
|
返回 Bool 值，指明某变量是否为数值类型。如果变量是数值类型，IsNumeric 返回 True；否则，返回 False。
|
|||||||||||||||||||||
|
Join
|
Join（字符串数组）
|
返回一个字符串，此字符串由包含在数组中的多个子字符串联接创建，各个子字符串之间采用分隔符隔开。
分隔符是字符串类型，可以是空字符串 ""
|
|||||||||||||||||||||
|
KeepScreen
|
KeepScreen （Bool类型表达式）
|
当指定的Bool类型表达式为True的时候，保持屏幕常开状态；否则，关闭屏幕常开功能（屏幕会自动关闭）。
|
|||||||||||||||||||||
|
LCase
|
LCase（字符串表达式）
|
返回字符串的小写形式。
仅大写字母转换成小写字母；所有小写字母和非字母字符保持不变。
|
|||||||||||||||||||||
|
Left
|
Left（字符串, 长度）
|
返回指定数目的从字符串的左边算起的字符。
指定的长度为数值表达式，指明要返回的字符数目。如果是 0，返回空字符串 ""；如果大于或等于字符串中的字符总数，则返回整个字符串。
|
|||||||||||||||||||||
|
Len
|
Len（字符串表达式）
|
返回字符串内字符的数目。
|
|||||||||||||||||||||
|
Log
|
Log（数字表达式）
|
返回数值的自然对数，即以常数 e 为底的对数。常数 e 的值约为 2.718282。
|
|||||||||||||||||||||
|
LTrim
|
LTrim（字符串表达式）
|
返回不带前导空格的字符串。
|
|||||||||||||||||||||
|
Mid
|
Mid（字符串, 起始位置, 长度）
|
从字符串中返回指定数目的字符。
起始位置和长度都是数值类型的表达式。
|
|||||||||||||||||||||
|
Now
|
Now
|
根据计算机系统设定的日期和时间，返回当前的日期和时间值组成的字符串。
|
|||||||||||||||||||||
|
Oct
|
Oct（数值表达式）
|
返回表示八进制数值的字符串。当指定的数值表达式包含小数位时，会先采用四舍五入的方式去掉小数位再转换。
|
|||||||||||||||||||||
|
PutAttachment
|
PutAttachment（路径, 要释放的文件）
PutAttachment 路径
|
把当前脚本包含的附件释放到指定的目录下。
路径是字符串类型，表示把附件文件释放到某个特定的目录下。
如果路径为Null或空字符串，会把附件释放到按键精灵的临时文件目录下。临时文件目录可以通过调用 GetTempDir() 获得。
要释放的文件（可选参数）为字符串类型，可以指定只释放附件中的一个或几个文件，支持通配符 * 和 ? 。
当不指定要释放的文件，或指定为Null或空字符串时，表示要释放本脚本附件中的所有文件。
|
|||||||||||||||||||||
|
Randomize
|
Randomize
Randomize 随机数种子
|
初始化随机数生成器。
|
|||||||||||||||||||||
|
Replace
|
Replace
（原字符串 , 查找的子字符串, 替换的字符串）
|
返回字符串，其中所有出现的某子字符串被替换为另一个字符串。
i="我爱你按键精灵"
ShowMessage Replace(i, "你", "")
运行可以看到“你”字被替换为空字符串，运行结果为"我爱按键精灵"。
|
|||||||||||||||||||||
|
RGB
|
RGB(数值R, 数值G, 数值B)
|
返回由红（由数值R表示）、绿（由数值G表示）、蓝（由数值B表示）三个分量组成的颜色值。
数值R, 数值G, 数值B的范围是0到255之间的整数，返回的颜色值也是数值型。
|
|||||||||||||||||||||
|
Right
|
Right（字符串, 长度）
|
返回指定数目的从字符串的右边算起的字符。
指定的长度为数值表达式，指明要返回的字符数目。如果是 0，返回空字符串 ""；如果大于或等于字符串中的字符总数，则返回整个字符串。
|
|||||||||||||||||||||
|
Round
|
Round（数值表达式）
|
返回经过四舍五入的数值。
|
|||||||||||||||||||||
|
RTrim
|
RTrim（字符串表达式）
|
返回不带后缀空格的字符串。
|
|||||||||||||||||||||
|
Sgn
|
Sgn（数值表达式）
|
返回表示数字符号的整数。
如果指定的数值表达式大于0，返回值为1；如果指定的数值表达式小于0，返回值为-1；如果指定的数值表达式等于0，返回值为0；
|
|||||||||||||||||||||
|
Space
|
Space(数值表达式)
|
返回由指定数目的空格组成的字符串。
|
|||||||||||||||||||||
|
Split
|
Split(原字符串, 分隔符)
|
返回一个数组，数组中的每个元素都是子字符串。由这些子字符串和分隔符构成原字符串。
分隔符也是字符串类型。
|
|||||||||||||||||||||
|
Sqr
|
Sqr（数值表达式）
|
返回数值的平方根。
数值表达式的值必须大于或等于零。
|
|||||||||||||||||||||
|
StrComp
|
StrComp(字符串1, 字符串2)
|
返回两个字符串比较的结果。
当字符串1小于字符串2时，返回-1；当字符串1等于字符串2时，返回0；当字符串1大于字符串2时，返回1；
|
|||||||||||||||||||||
|
StrReverse
|
StrReverse(字符串)
|
返回字符串，此字符串与指定字符串顺序相反。
|
|||||||||||||||||||||
|
String
|
String(数量, 指定字符)
|
返回具有指定长度的、重复字符组成的字符串。
指定字符可以是字符串类型表达式，若其中包含不止一个字符，则仅使用其中第一个字符。
指定字符也可以是数值类型表达式，表示字符的ASCII码。
|
|||||||||||||||||||||
|
Swipe
|
Swipe （点1的横坐标, 点1的纵坐标, 点2的横坐标, 点2的纵坐标）
|
模拟手指在屏幕上的划动操作。从点1滑动到点2。
|
|||||||||||||||||||||
|
Tan
|
Tan(数值表达式)
|
返回将某个角表示为弧度数值的正切值。
即取某个角并返回直角三角形两边的比值。此比值是直角三角形中该角的对边长度与临边长度之比。
将角度乘以 pi/180 即可转换为弧度，将弧度乘以 180/pi 即可转换为角度。
|
|||||||||||||||||||||
|
TracePrint
|
TracePrint（表达式）
|
将表达式转换为字符串类型后，发往按键精灵手机助手，并在按键精灵手机助手的调试栏显示出来。
|
|||||||||||||||||||||
|
Trim
|
Trim（字符串表达式）
|
返回不带前导空格和后缀空格的字符串。
|
|||||||||||||||||||||
|
UCase
|
UCase（字符串表达式）
|
返回字符串的大写形式。
仅小写字母转换成大写字母；所有大写字母和非字母字符保持不变。
|
|||||||||||||||||||||
|
Vibrate
|
Vibrate（数值表达式）
|
在具有震动功能的设备上，维持震动一段时间。
维持的时间由数值表达式指定，表示以毫秒数为单位的时间。
|
|||||||||||||||||||||
|
GetDeviceID
|
GetDeviceID
|
返回设备的唯一编号
|
|||||||||||||||||||||
|
FindColor
|
FindColor
|
在屏幕中指定区域内，查找是否存在某个指定颜色。若找到，将找到的点的左边置于后两个参数（通常为变量）中；如果没有找到，则后两个参数均被置为-1。
16进制颜色值可以为字符串，格式为"BBGGRR"，亦可为此字符串对应的16进制数值。
查找方式为0时，表示从左上向右下查找；为1时，表示从中心往四周查找；为2时，表示从右下向左上查找；为3时，表示从左下向右上查找；为4时，表示从右上向左下查找。
相似度为0到1之间的数值。此数值为1时，屏幕上的颜色必须与指定的颜色完全一致才算找到；否则，当存在少量偏差时也算找到。此数值越小，允许的颜色偏差范围越大。
|
|||||||||||||||||||||
|
FindPic
|
FindPic
|
在屏幕中指定的区域内，查找是否存在某个图片文件所指定的图像。如果找到，将找到的点的左边置于后两个参数（通常为变量）中；如果没有找到，则后两个参数均被置为-1。
16进制颜色值可以为字符串，格式为"BBGGRR"，亦可为此字符串对应的16进制数值。
查找方式为0时，表示从左上向右下查找；为1时，表示从中心往四周查找；为2时，表示从右下向左上查找；为3时，表示从左下向右上查找；为4时，表示从右上向左下查找。
相似度为0到1之间的数值。此数值为1时，屏幕上的颜色必须与指定的颜色完全一致才算找到；否则，当存在少量偏差时也算找到。此数值越小，允许的颜色偏差范围越大。
支持的图片文件格式包括PNG、BMP、JPG等，推荐用PNG格式，PNG格式图片中所指定透明点表示该点不会参与匹配过程的计算，也就是该点与屏幕上的任何颜色都会匹配成功。
图片文件名如果以 "Attachment:" 开始，表明后面的部分是附件中的文件。按键精灵会自动从附件中找到该文件并进行找图，不需要将附件释放到存储卡上。
|
|||||||||||||||||||||
|
Delay
|
Delay
|
脚本暂停执行一段时间。数值表达式指定了延时的“毫秒”数。例如：
1秒＝1000毫秒 1分钟＝60000毫秒 1小时＝3600000毫秒
|
|||||||||||||||||||||
|
GetScreenX
|
GetScreenX
|
返回当前屏幕的横向分辨率，即以像素数表示的屏幕宽度。
|
|||||||||||||||||||||
|
GetScreenY
|
GetScreenY
|
返回当前屏幕的纵向分辨率，即以像素数表示的屏幕高度。
|
|||||||||||||||||||||
|
GetScreenColorDep
|
GetScreenColorDep
|
返回当前屏幕的颜色深度，即每个像素用多少个二进制位（Bit）表示，通常屏幕的颜色深度为16或24或32。
|
|||||||||||||||||||||
|
GetTempDir
|
GetTempDir
|
返回存储卡上按键精灵的临时文件目录，可以在此目录中进行文件操作。
|
|||||||||||||||||||||
|
ColorToRGB
|
ColorToRGB
|
把颜色分解为红、绿、蓝三个分量，分别保存在变量R，变量G，变量B中。
16进制颜色值可以为字符串，格式为"BBGGRR"，也可以为此字符串对应的16进制数值。
|
|||||||||||||||||||||
|
ColorDiff
|
ColorDiff
|
返回两个颜色的红、绿、蓝三个分量的差值之总和。
|
|||||||||||||||||||||
|
GetPixelColor
|
GetPixelColor
|
返回屏幕上指定点的颜色。由两个数值型表达式指定该点的横坐标和纵坐标（以像素为单位）。
返回的颜色值也是数值型。
|
|||||||||||||||||||||
|
InputText
|
InputText
|
在当前窗口中输入文字。例如：InputText "你好，我是按键精灵"。
|
|||||||||||||||||||||
|
KeyPress
|
KeyPress
|
先“按下”再“弹起”键，模拟我们平时的按键操作。
指定的按键可以是字符串类型，表示某个键的名字，也可以是数值类型，表示某个键的编码。
|
|||||||||||||||||||||
|
KeyDown
|
KeyDown
|
“按下”键，模拟我们平时的“按下”操作
指定的按键可以是字符串类型，表示某个键的名字，也可以是数值类型，表示某个键的编码。
|
|||||||||||||||||||||
|
KeyUp
|
KeyUp
|
“弹起”键，模拟我们平时的“弹起”操作
指定的按键可以是字符串类型，表示某个键的名字，也可以是数值类型，表示某个键的编码。
|
|||||||||||||||||||||
|
KillApp
|
KillApp
|
指定某个应用程序的包名，关闭这个应用程序。
|
|||||||||||||||||||||
|
PlaySound
|
PlaySound 文件名
|
播放指定的音频文件，其中文件名为字符串类型的表达式，指明了音频文件的存储位置。
|
|||||||||||||||||||||
|
Rnd
|
Rnd
|
返回一个小于 1 但大于或等于 0 的随机数。
在调用 Rnd 之前，先使用 Randomize 语句初始化随机数生成器。
要产生指定范围的随机整数，请使用以下公式：
Int((upperbound - lowerbound + 1) * Rnd + lowerbound)
这里，upperbound 是此范围的上界，而 lowerbound 是此范围内的下界。
|
|||||||||||||||||||||
|
RunApp
|
RunApp
|
指定某个应用程序的包名，启动这个应用程序。
|
|||||||||||||||||||||
|
ShowMessage
|
ShowMessage
|
在屏幕上显示提示信息，此信息将会维持一定时间后自动消失。
如果提示信息不是字符串类型，会自动转换为字符串类型进行显示。
|
|||||||||||||||||||||
|
SnapShot
|
SnapShot 文件名
|
截屏并保存为PNG格式的图片文件。
|
|||||||||||||||||||||
|
Time
|
Time
|
返回当前系统时间。
|
|||||||||||||||||||||
|
Touch
|
Touch 横坐标, 纵坐标, 持续时间
|
点击屏幕上的指定位置，并持续按住一段时间再松开。
|
|||||||||||||||||||||
|
Tap
|
Tap 横坐标, 纵坐标
|
短暂点击屏幕上指定的位置
|
|||||||||||||||||||||
|
新增命令hot
|
|||||||||||||||||||||||
|
KeepCapture
|
call KeepCapture() 或
变量=KeepCapture()
|
KeepCapture的作用是截一次图，并把截图结果暂时保留下来，后续的找图、找色、取色都会直接从这个截图里面操作。而不会重新截图。此命令激活会大大加快后续的找图找色指令速度和效率！
|
|||||||||||||||||||||
|
ReleaseCapture
|
ReleaseCapture和KeepCapture成对使用，解除KeepCapture的效果，也就是说，后续的找图、找色、取色每次都会重新截图
|
ReleaseCapture和KeepCapture成对使用，解除KeepCapture的效果，也就是说，后续的找图、找色、取色每次都会重新截图
|
|||||||||||||||||||||
|
|||||||||||||||||||||||