← 浏览器控件(BROWSER)

须知：因该控件使用IE内核，不支持高级浏览器特性。

该控件特有的属性

• 网址
  url
  字符串，设置后控件自动加载该网址。
• 源代码
  source
  字符串，设置后控件直接将该html源代码展示为页面。
• 执行脚本
  execScript
  字符串，javascript脚本代码，设置后立即执行。
• 注入脚本代码
  injectScriptBySource
  字符串，javascript脚本代码，当每次页面加载完毕后执行该代码。
• 注入脚本文件
  injectScriptByLocal
  字符串，脚本文件(.js)路径，当每次页面加载完毕后执行该文件中的javascript代码。文件编码必须是utf-8。
• 注入url脚本
  injectScriptByUrl
  字符串，脚本文件url，当每次页面加载完毕后加载该js文件。
• 注入样式代码
  injectStyleBySource
  字符串，css代码，当每次页面加载完毕后执行该代码。
• 注入css文件
  injectStyleByLocal
  字符串，css文件(.css)路径，当每次页面加载完毕后执行该文件中的css代码。文件编码必须是utf-8。
• 注入url样式
  injectStyleByUrl
  字符串，css文件url，当每次页面加载完毕后加载该css文件。

接口调用

该控件提供了非常多的接口供javascript代码调用，调用方式为external.方法名(参数们);

• 添加操作
  addAction
  
  • 参数1：任务名称(字符串)
  • 参数2：操作类型(字符串)
  • 参数3：动作(字符串)

  调用后在给任务添加操作的同时还会修改配置文件的哦。

• 添加带标签的操作
  addActionWithLabel
  
  • 参数1：任务名称(字符串)
  • 参数2：操作类型(字符串)
  • 参数3：动作(字符串)
  • 参数4：自定义标签(字符串)

  调用后在给任务添加操作的同时还会修改配置文件的哦。

• 给指定操作追加一个参数
  addActionArg
  
  • 参数1：任务名称(字符串)
  • 参数2：操作序号(数字，从0开始计)
  • 参数3：追加参数值

  调用后在给操作追加参数的同时还会修改配置文件的哦。

• 添加配置
  addProfile
  
  • 参数1：待添加的配置名称(字符串)
  • 参数2：监控变量名(字符串)
  • 参数3：操作符(字符串)
  • 参数4：值
  • 参数5：待执行任务名称(字符串)

  调用后在添加配置的同时还会修改配置文件的哦。

• 添加场景
  addScene
  
  • 参数1：待添加的场景名称(字符串)

  调用后在添加场景的同时还会修改配置文件的哦。

• 添加控件
  addSceneUnit
  
  • 参数1：场景名称(字符串)
  • 参数2：待添加控件名称(字符串)
  • 参数3：待添加控件类型(字符串)

  调用后在添加控件的同时还会修改配置文件的哦。

• 添加任务
  addTask
  
  • 参数1：待添加任务名称(字符串)

  调用后在添加任务的同时还会修改配置文件的哦。

• 播放窗体动画
  animateWindow
  
  • 参数1：窗体句柄(字符串)
  • 参数2：动画时长(数字，毫秒数)
  • 参数3：动画类型标志(数字)

  动画类型标志（可多种动画类型相加实现叠加效果）： 1自左向右显示窗口。只能在滚动动画中使用。当使用16标志时，该标志将被忽略。 2自右向左显示窗口。只能在滚动动画中使用。当使用16标志时，该标志将被忽略。 4自上向下显示窗口。只能在滚动动画中使用。当使用16标志时，该标志将被忽略。 8自下向上显示窗口。只能在滚动动画中使用。当使用16标志时，该标志将被忽略。 16若使用65536，则窗口向内重叠；若未使用65536，则窗口向外扩展。 65536隐藏窗口。 131072激活窗口，不能和65536叠加。 262144滚动动画。当使用16标志时，该标志将被忽略。 524288淡入效果。

• 发出蜂鸣音
  beep
  
  • 参数1：声音频率(数字)
  • 参数2：持续时长(数字)
• 屏幕截图
  captureScreen
  
  • 无参数

  无返回值，截取的图片缓存在图像缓冲区（在itask未重启，图片未被替换，缓冲区未被清理时将一直存在）。

• 单击鼠标左键
  click
  
  • 无参数
• 执行命令提示符
  cmd
  
  • 参数1：命令内容(字符串)

  返回值：同步返回命令执行结果内容(字符串)

• 后台执行命令提示符
  cmdInBackground
  
  • 参数1：命令内容(字符串)

  调用该方法不会等待命令返回结果

• 复制文件
  copyFileTo
  
  • 参数1：原文件路径
  • 参数2：新文件路径
  • 参数3：是否允许覆盖true/false
• 获取进程数量
  countApps
  
  • 无参数

  返回值：进程数(数字)

• 创建目录
  createDir
  
  • 参数1：路径(字符串)

  返回值：是否创建成功(true/false)

• 给已生成的窗体动态添加控件
  createFormUnit
  
  • 参数1：场景名称(字符串)
  • 参数2：控件名称(字符串)
  • 参数3：控件类型(字符串)
• 创建窗体
  createForm
  
  • 参数1：场景名称(字符串)
• 裁剪缓存图片
  cropImage
  
  • 参数1：X坐标(整数)
  • 参数2：Y坐标(整数)
  • 参数3：宽度(整数)
  • 参数4：高度(整数)
• 获取当前播放媒体的当前进度(秒数)
  currentMedia
  
  • 无参数
• 获取当前播放媒体的文件路径
  currentMediaFile
  
  • 无参数
• 删除目录
  destroyDir
  
  • 参数1：路径(字符串)
  • 参数2：是否删除子目录(true/false)
• 删除文件
  destroyFile
  
  • 参数1：路径(字符串)
• 销毁窗体
  destroyForm
  
  • 参数1：场景名称(字符串)
• 销毁窗体上的控件
  destroyFormUnit
  
  • 参数1：场景名称(字符串)
  • 参数2：控件名称(字符串)
• 清除缓冲区图像
  destroyImage
  
  • 无参数

  无返回值

• HTTP下载文件
  download
  
  • 参数1：url(字符串)
  • 参数2：本地存储文件路径。
  • 参数3：构造请求头(字符串)，键值之间用:分隔，如：Host:6tail.cn。多个请求头之间使用\n分隔。

  返回值：true/false

• 退出itask程序
  exit
  
  • 无参数
• 结束应用程序或进程
  exitApp
  
  • 参数1：操作符(操作符用于指定匹配方式，参考配置中的操作符介绍)
  • 参数2：exe文件路径或进程名称(字符串)
• 查找窗体
  findWindow
  
  • 参数1：类名(字符串，可为空)
  • 参数2：窗体名(字符串，可为空)

  返回值：找到的窗体句柄。

• 水平翻转缓存图片
  flipImageX
  
  • 无参数
• 垂直翻转缓存图片
  flipImageY
  
  • 无参数
• GET请求
  get
  
  • 参数1：url(字符串)
  • 参数2：页面编码(字符串)，如GB2312等，如果为空字符串，则自动探测。
  • 参数3：构造请求头(字符串)，键值之间用:分隔，如：Host:6tail.cn。多个请求头之间使用\n分隔。

  返回值：请求返回结果字符串

• 获取操作的参数数量
  getActionArgSize
  
  • 参数1：任务名称(字符串)
  • 参数2：操作序号(数字，从0开始计)
• 获取当前操作的动作
  getActionOp
  
  • 无参数
• 获取操作数量
  getActionSize
  
  • 参数1：任务名称(字符串)
• 获取当前操作类型
  getActionType
  
  • 无参数
• 获取进程数量
  getAppCount
  
  • 无参数

  返回值：进程数量(整数)

• 获取剪贴板内容
  getClip
  
  • 无参数

  返回值：剪贴板内容(字符串)

• 获取itask目录路径
  getContext
  
  • 无参数

  返回值：itask所在路径(字符串)

• 获取文件所在路径
  getFileDirectory
  
  • 参数1：路径(字符串)

  返回值：文件所在路径(字符串)

• 获取文件扩展名
  getFileExtension
  
  • 参数1：路径(字符串)

  返回值：文件扩展名(字符串)，带.号

• 获取文件名
  getFileShortName
  
  • 参数1：路径(字符串)

  返回值：文件名(字符串)，不含所在路径，含扩展名

• 获取不含扩展名的文件名
  getFileShortNameWithoutExtension
  
  • 参数1：路径(字符串)

  返回值：文件名(字符串)，不含所在路径，不含扩展名

• 获取当前激活窗体
  getForegroundWindow
  
  • 无参数

  返回值：窗体句柄(字符串)，如果不存在，返回空字符串

• 获取全局变量值
  getGlobal
  
  • 参数1：变量名称(字符串)

  返回值：变量值(字符串)，如果不存在该变量，返回空字符串

• 获取本地应用程序文件图标
  getIcon
  
  • 参数1：文件路径(字符串)

  返回值：图片base64编码(字符串)，以data:image/png;base64,开头

• 获取本地图片
  getImage
  
  • 参数1：图片路径(字符串)

  返回值：图片base64编码(字符串)，以data:image/png;base64,开头

• 获取本地图片
  getImageByFormat
  
  • 参数1：图片路径(字符串)
  • 参数2：图片格式(字符串，如jpg、bmp、png等)

  返回值：以指定格式进行图片base64编码(字符串)，以data:image/格式;base64,开头

• 获取缓存图片指定坐标的颜色代码
  getImageColor
  
  • 参数1：X坐标(整数)
  • 参数2：Y坐标(整数)

  返回值：颜色代码，如#000000

• 获取缓存图片高度
  getImageHeight
  
  • 无参数

  返回值：整数，如果无法获取返回0

• 获取缓存图片宽度
  getImageWidth
  
  • 无参数

  返回值：整数，如果无法获取返回0

• 获取任务局部变量
  getLocal
  
  • 参数1：任务名称(字符串)
  • 参数2：变量名(字符串)

  返回值：变量值(字符串)

• 获取鼠标指针在屏幕上的X坐标
  getMouseX
  
  • 无参数

  返回值：X坐标(整数)

• 获取鼠标指针在屏幕上的Y坐标
  getMouseY
  
  • 无参数

  返回值：Y坐标(整数)

• 获取当前场景名称
  getSceneName
  
  • 无参数

  返回值：场景名称(字符串)

• 获取屏幕上指定点的颜色
  getScreenColor
  
  • 参数1：X坐标(整数)
  • 参数2：Y坐标(整数)

  返回值：以#开头的颜色代码(字符串)，例如：#FFFFFF

• 获取屏幕高度
  getScreenHeight
  
  • 无参数

  返回值：整型

• 获取屏幕宽度
  getScreenWidth
  
  • 无参数

  返回值：整型

• 获取当前任务名称
  getTaskName
  
  • 无参数

  返回值：任务名称(字符串)

• 在状态栏图标右键菜单中隐藏指定任务名称
  hideTask
  
  • 参数1：任务名称(字符串)
• 应用程序是否运行中
  isAppRunning
  
  • 参数1：应用程序文件路径或进程名称(字符串)

  返回值：true/false

• 目录是否存在
  isDirectoryExists
  
  • 参数1：目录路径(字符串)

  返回值：true/false

• 文件是否存在
  isFileExists
  
  • 参数1：文件路径(字符串)

  返回值：true/false

• 窗体是否存活（未被销毁）
  isFormAlive
  
  • 参数1：场景名称(字符串)

  返回值：true/false

• 让鼠标左键按下
  leftDown
  
  • 无参数
• 让鼠标左键弹起
  leftUp
  
  • 无参数
• 获取当前播放媒体总时长(秒数)
  lengthMedia
  
  • 无参数
• 获取进程名称列表
  listApps
  
  • 无参数

  返回值：以\n分隔的进程名称字符串

• 指定文件夹下的文件列表
  listFiles
  
  • 参数1：文件夹路径

  返回值：以\n分隔的字符串

• 获取配置名称列表
  listProfiles
  
  • 无参数

  返回值：以\n分隔的字符串

• 获取场景属性列表
  listSceneProps
  
  • 参数1：场景名称

  返回值：以\n分隔的字符串

• 获取场景名称列表
  listScenes
  
  • 无参数

  返回值：以\n分隔的字符串

• 获取场景控件属性列表
  listSceneUnitProps
  
  • 参数1：场景名称
  • 参数2：控件名称

  返回值：以\n分隔的字符串

• 获取场景控件名称列表
  listSceneUnits
  
  • 参数1：场景名称

  返回值：以\n分隔的字符串

• 获取任务名称列表
  listTasks
  
  • 无参数

  返回值：以\n分隔的字符串

• 获取所有窗体列表
  listWindows
  
  • 无参数

  返回值：以\n分隔的窗体句柄字符串

• 启动应用程序
  loadApp
  
  • 参数1：应用程序路径

  返回值：是否成功启动(true/false)

• 加载图片
  loadImage
  
  • 参数1：图片路径

  无返回值，加载的图片缓存在图像缓冲区（在itask未重启，图片未被替换，缓冲区未被清理时将一直存在）。

• 锁定屏幕
  lockScreen
  
  • 无参数
• 写日志
  log
  
  • 参数1：日志级别(字符串：debug、info、warn、error)
  • 参数2：日志内容(字符串)
• 点击鼠标中键
  middleClick
  
  • 无参数
• 让鼠标中键按下
  middleDown
  
  • 无参数
• 让鼠标中键弹起
  middleUp
  
  • 无参数
• 移动文件
  moveFileTo
  
  • 参数1：原文件路径
  • 参数2：新文件路径

  可以变通为重命名，如：moveFileTo('D:\\1.txt','D:\\2.txt')

• 让鼠标指针移动至屏幕指定坐标
  moveMouseTo
  
  • 参数1：X坐标
  • 参数2：Y坐标
• 取消系统静音
  muteOff
  
  • 无参数
• 系统静音
  muteOn
  
  • 无参数
• 暂停当前媒体播放
  pauseMedia
  
  • 无参数
• 暂停当前MIDI音乐播放
  pauseMidi
  
  • 无参数
• 执行指定任务
  performTask
  
  • 参数1：任务名称(字符串)

  返回值：任务执行是否成功(true/false)

• 播放媒体
  playMedia
  
  • 参数1：文件路径(字符串)，支持mp3和wav格式
• 播放MIDI音乐
  playMidi
  
  • 参数1：音色（数字0-127），请参考MIDI音色
  • 参数2：以几分音符为一拍（字符串），如4/4
  • 参数3：每分钟拍数（字符串），如80
  • 参数4：调式（字符串），如G
  • 参数5：简谱，更多简谱请参考MIDI简谱
• 播放系统声音
  playSound
  
  • 参数1：声音类型(字符串)，可选项Asterisk/Beep/Exclamation/Hand/Question
• POST请求
  post
  
  • 参数1：url(字符串)
  • 参数2：参数(以&分隔的字符串，如a=1&b=2)
  • 参数3：页面编码(字符串)，如GB2312等，如果为空字符串，则自动探测。
  • 参数4：构造请求头(字符串)，键值之间用:分隔，如：Host:6tail.cn。多个请求头之间使用\n分隔。

  返回值：请求返回结果字符串

• 读取操作属性
  readAction
  
  • 参数1：任务名称(字符串)
  • 参数2：操作序号(数字，以0开始计)
  • 参数3：属性名(字符串)

  返回值：属性值(字符串)

• 读取操作参数
  readActionArg
  
  • 参数1：任务名称(字符串)
  • 参数2：操作序号(数字，以0开始计)
  • 参数3：参数序号(数字，以0开始计)

  返回值：参数值(字符串)

• 读取进程属性
  readApp
  
  • 参数1：进程名称(字符串)
  • 参数2：属性名称(字符串)

  返回值：属性值(字符串)。属性名支持：count(进程数量)、id(获取指定进程的id，需要追加一个参数：进程名称)、window_handle(获取指定进程的主窗体句柄，需要追加一个参数：进程名称)、window_title(获取指定进程的主窗体标题，需要追加一个参数：进程名称)。

• 读取文本文件内容
  readFile
  
  • 参数1：文件路径(字符串)
  • 参数2：文件编码(字符串，如GB2312)

  返回值：文件内容(字符串)

• 读取窗体属性
  readForm
  
  • 参数1：场景名称(字符串)
  • 参数2：属性名称(字符串)

  返回值：属性值(字符串)

• 读取窗体控件属性
  readFormUnit
  
  • 参数1：场景名称(字符串)
  • 参数2：控件名称(字符串)
  • 参数3：属性名称(字符串)

  返回值：属性值(字符串)

• 读取配置属性
  readProfile
  
  • 参数1：配置名称(字符串)
  • 参数2：属性名称(字符串)

  返回值：属性值(字符串)

• 读取场景自有属性
  readScene
  
  • 参数1：场景名称(字符串)
  • 参数2：属性名称(字符串)，目前只有name属性

  返回值：属性值(字符串)

• 读取场景属性节点
  readSceneProp
  
  • 参数1：场景名称(字符串)
  • 参数2：属性节点名称(字符串)，如width、height等

  返回值：属性值(字符串)

• 读取场景控件自有属性
  readSceneUnit
  
  • 参数1：场景名称(字符串)
  • 参数2：控件名称(字符串)
  • 参数3：属性名称(字符串)，目前只有name、type属性

  返回值：属性值(字符串)

• 读取场景控件属性节点
  readSceneUnitProp
  
  • 参数1：场景名称(字符串)
  • 参数2：控件名称(字符串)
  • 参数3：属性节点名称(字符串)，如width、height等

  返回值：属性值(字符串)

• 读取任务属性
  readTask
  
  • 参数1：任务名称(字符串)
  • 参数2：属性名称(字符串)

  返回值：属性值(字符串)

• 读取窗体属性
  readWindow
  
  • 参数1：窗体句柄(字符串)
  • 参数2：属性名称(字符串)

  返回值：属性值(字符串)

  支持的属性有：text（窗体标题）；left（横坐标）；top（纵坐标）；width（宽度）；height（高度）；visible（是否可见）

• 缩放缓存图片
  resizeImage
  
  • 参数1：宽度(整数)
  • 参数2：高度(整数)
• 重启itask
  restart
  
  • 无参数
• 恢复当前媒体播放
  resumeMedia
  
  • 无参数
• 恢复当前MIDI音乐播放
  resumeMidi
  
  • 无参数
• 单击鼠标右键
  rightClick
  
  • 无参数
• 让鼠标右键按下
  rightDown
  
  • 无参数
• 让鼠标右键弹起
  rightUp
  
  • 无参数
• 保存图片
  saveImage
  
  • 参数1：图片路径

  无返回值，将缓存的图片保存到文件。

• 弹出文件夹选择框，让用户选择目录
  selectDir
  
  • 无参数

  返回值：用户选择的路径，如果未选择，返回空字符串

• 弹出文件选择框，让用户选择文件
  selectFile
  
  • 无参数

  返回值：用户选择的路径，如果未选择，返回空字符串

• 模拟异步键盘按键
  sendKeys
  
  • 字符串（参考：键盘按键）

  仅仅将键盘按键消息放入系统消息队列，不会等待执行完毕，即异步发送。若要同步发送，请调用waitKeys方法。

• 设置剪贴板内容
  setClip
  
  • 参数1：字符串内容
• 修改或设置全局变量
  setGlobal
  
  • 参数1：变量名称(字符串)
  • 参数2：变量值(字符串)
• 修改或设置任务局部变量
  setLocal
  
  • 参数1：任务名称(字符串)
  • 参数2：变量名称(字符串)
  • 参数3：变量值(字符串)
• 设置系统音量
  setVolume
  
  • 参数1：音量值(整数)，0-50
• 弹出对话框
  showAlert
  
  • 参数1：标题(字符串)
  • 参数2：内容(字符串)
• 在状态栏图标右键菜单中添加任务名称，点击后执行该任务
  showTask
  
  • 参数1：任务名称(字符串)
• 在状态栏图标弹出气泡提示
  showTip
  
  • 参数1：标题(字符串)
  • 参数2：内容(字符串)
• 停止当前媒体播放
  stopMedia
  
  • 无参数
• 停止当前MIDI音乐播放
  stopMidi
  
  • 无参数
• 减小系统音量
  volumeDown
  
  • 无
• 增大系统音量
  volumeUp
  
  • 无
• 模拟同步键盘按键
  waitKeys
  
  • 字符串（参考：键盘按键）

  等待按键消息被处理后才返回，即同步发送按键。若要异步发送，请调用sendKeys方法。

• 向后(即向自己方向)滑动鼠标滚轮
  wheelBack
  
  • 无
• 向前(即向自己前方)滑动鼠标滚轮
  wheelForward
  
  • 无
• 设置操作属性
  writeAction
  
  • 参数1：任务名称(字符串)
  • 参数2：操作序号(数字，以0开始计)
  • 参数3：属性名(字符串)
  • 参数4：属性值(字符串)
• 设置操作参数
  writeActionArg
  
  • 参数1：任务名称(字符串)
  • 参数2：操作序号(数字，以0开始计)
  • 参数3：参数序号(数字，以0开始计)
  • 参数4：参数值(字符串)
• 写文本内容到文件中
  writeFile
  
  • 参数1：文件路径(字符串)
  • 参数2：文本内容(字符串)
  • 参数3：是否在文件末尾追加内容(true/false)
  • 参数4：文件编码(字符串，如GB2312)
• 设置窗体属性
  writeForm
  
  • 参数1：场景名称(字符串)
  • 参数2：属性名称(字符串)
  • 参数3：属性值(字符串)
• 设置窗体控件属性
  writeFormUnit
  
  • 参数1：场景名称(字符串)
  • 参数2：控件名称(字符串)
  • 参数3：属性名称(字符串)
  • 参数4：属性值(字符串)
• 设置配置属性
  writeProfile
  
  • 参数1：配置名称(字符串)
  • 参数2：属性名称(字符串)
  • 参数3：属性值(字符串)
• 设置场景自有属性
  writeScene
  
  • 参数1：场景名称(字符串)
  • 参数2：属性名称(字符串)，目前只有name属性
  • 参数3：属性值(字符串)
• 设置场景属性节点
  writeSceneProp
  
  • 参数1：场景名称(字符串)
  • 参数2：属性节点名称(字符串)，如width、height等
  • 参数3：属性值(字符串)
  • 参数4：属性值(字符串)
• 设置场景控件自有属性
  writeSceneUnit
  
  • 参数1：场景名称(字符串)
  • 参数2：控件名称(字符串)
  • 参数3：属性名称(字符串)，目前只有name、type属性
  • 参数4：属性值(字符串)
• 设置场景控件属性节点
  writeSceneUnitProp
  
  • 参数1：场景名称(字符串)
  • 参数2：控件名称(字符串)
  • 参数3：属性节点名称(字符串)，如width、height等
  • 参数4：属性值(字符串)
• 设置任务属性
  writeTask
  
  • 参数1：任务名称(字符串)
  • 参数2：属性名称(字符串)
  • 参数3：属性值(字符串)
• 设置窗体属性
  writeWindow
  
  • 参数1：窗体句柄(字符串)
  • 参数2：属性名称(字符串)
  • 参数3：属性值(字符串)

  支持的属性有：active（激活窗体，值为空）；bringToFront（将窗体带到前面，值为空）；windowState（设置窗体状态，可选值：Maximized、Minimized、Normal、Hide）