UiBot工程常用函数补充集合模块分享

本文仅作分享之用，有任何问题或下载模块附件请访问原帖：https://forum.uibot.com.cn/thread-5343.htm

 

UiBot导入与使用模块的方法

将 x.task 文件复制到流程文件夹中，即可在其他流程块中引用：

在流程块中开头处插入 import x 和 x.Init 两行，即可在接下来的代码中调用其他的函数。比如：x.Complete("功能名")

如果你的流程块中包含了多个单独的功能函数，则需要在每个单独的功能函数开头处插入 x.Init。

 

UiBot工程常用函数函数表

序号 函数 释义

1	Init()	初始化系统，需要在每一个引用了本模块的模块开头调用
2	ShowErr(e)	弹出消息框提示错误。参数 e：要提示的错误字符串
3	GetErr(e)	获取错误信息。参数 e：用从 catch e 中得到的变量 e
4	PrintErr(e,n=0)	打印并将错误信息写入日志。参数 e：同上；参数 n：尝试的次数，默认不打印
5	Warn(s,i=2)	输出警告信息。参数 s：要输出的字符串；参数 i：弹出消息提示的图标类型，设为 -1 则不弹出消息提示
6	Info(s,i=1)	输出提示信息。参数：同上
7	Complete(name="")	输出完成情况。参数 name：完成的步骤的名称
8	CompleteMsgBox(name="")	弹出完成情况消息框。参数：同上
9	SheetInBook(ewb,sheet)	检查工作簿中是否存在相应的工作表。参数 ewb：ExcelWorkBook 对象；参数 sheet：工作表名称字符串；返回值：是否存在相应的工作表
10	RecreateSheet(ewb,sheet)	重新创建工作表。参数：同上
11	SplitEx(s,d)	对字符串 s 进行拆分，根据 d 内的每一个字符
12	SplitFine(s,d)	对字符串 s 进行拆分，根据 d 内的每一个字符，去除结果两端的空格，删除空白结果
13	SumNum(s)	对"1.1+1.2"这类字符串进行求和
14	ExtractNum(s)	从字符串中提取第一个小数
15	ExtractNums(s)	从字符串中提取所有小数
16	ExtractNotNum(s)	从字符串中提取非小数部分
17	DealKMB(s)	展开 K、"M"、"B"、"k"、"m"、"b"
18	GetPathAvailable(path)	获取不重复的保存路径
19	GetPath(s)	从完整路径中获取文件所在目录的路径
20	GetFileName(path)	取得文件名称
21	GetFileTitle(path)	取得文件标题（即不含扩展名）
22	TestFile( p)	检测文件是否存在，如果不存在则弹出提示消息框，并退出
23	TestFolder( p)	检测文件夹是否存在，如果不存在则弹出提示消息框，并退出
24	WaitURL(hWeb,URL,times=6)	等待指定的URL出现。参数 hWeb：浏览器句柄；参数 URL：指定的 URL；参数 times：尝试的次数（每两次尝试的时间间隔为 500 毫秒）
25	GetIE()	获取当前已打开的 IE 浏览器，不存在则打开新的浏览器
26	GetChrome()	获取当前已打开的 Chrome 浏览器，不存在则打开新的浏览器
27	KillExcel()	如果存在，则关闭 WPS 和 Excel 进程
28	SetWindow(desc,target,xScale=0,topmost="",err=0,left=0,top=0,width=0,height=0)	设置（左对齐的）窗口显示方式。参数 desc：窗口程序的描述（名称）；参数 target：窗口目标；参数 xScale：横向占比（相对于屏幕）；参数 topmost：设为 TRUE 则进行窗口置顶，设为 FALSE 则取消窗口置顶，默认无动作；参数 err：当目标窗口不存在时，设为大于 0 则抛出异常，设为小于 0 则退出函数并返回 true，设为 0 则弹出消息框并退出程序；参数 left、top、width、height：忽略参数 xScale，直接设置窗口的位置与大小
29	SetIE(xScale=0,topmost="",err=0,left=0,top=0,width=0,height=0)	设置 IE 的显示方式。参数：同上
30	SetChrome(xScale=0,topmost="",err=0,left=0,top=0,width=0,height=0)	设置 Chrome 的显示方式。参数：同上
31	SetWPS(xScale=0,topmost="",err=0,left=0,top=0,width=0,height=0)	设置 WPS 的显示方式。参数：同上
32	SetExcel(xScale=0,topmost="",err=0,left=0,top=0,width=0,height=0)	设置 Excel 的显示方式。参数：同上
33	SetRightWindow(desc,target,xScale=0,topmost="",err=0,left=0,top=0,width=0,height=0)	设置右对齐的窗口显示方式。参数：同上
34	LocFile(dir,reFilename,name,sFilter,dirDef=@res"",cancel=0)	定位文件，如果不存在则弹出打开文件对话框。参数 dir：要定位的文件所在的目录；参数 reFilename：文件名的正则表达式字符串；参数 name：提示的文件名字符串；参数 sFilter：打开文件对话框的文件类型过滤描述字符串；参数 dirDef：打开文件对话框的默认目录；参数 cancel：如果在打开文件对话框中点击取消，设为大于 0 将直接退出程序，默认设为 0，将返回空字符串
35	GetCSV(dir)	获取目录中的第一个 CSV 文件的完整路径
36	ExcelReadAll(file)	获取一个指定的 Excel 表格文件中第一个工作表的内容。返回值：包含第一个工作表所有内容的二维数组
37	ReadCSV(file)	获取一个指定的 CSV 文件的内容。返回值：包含文件所有内容的二维数组
38	InArrayA(a,b)	测试在数组 a 中是否能找到数组 b 中的元素
39	InArrayN(a,b)	返回在数组 a 中找到 b 元素的第一个位置
40	A2FindRe(a,s)	在二维数组 a 中查找匹配正则表达式 s 的元素，并返回位置
41	A2GetRe(a,s)	在二维数组 a 中获取匹配正则表达式 s 的元素
42	TransP(a)	转置二维数组 (a[]中不能有null元素，否则结果会出错)
43	InputText(s,a=0,b=0)	键入文本。参数 s：要键入的文本；参数 a：执行后延迟；参数 b：执行前延迟
44	GetParentPath(path,n=1)	取得路径的上级路径。参数 n：级数，默认为 1，则返回上一级的路径
45	FindHeader(a,b,file="")	查找相应表头的位置。参数 a：被查找的数据；参数 b：要查找的表头；参数 file：如果没有找到对应的表头，则抛出异常提示中的文件名，默认不抛出异常
46	AFind(a,b)	在数组 a 中查找 b 中相应的元素的位置，如果没有找到则返回 -1
47	DicComp(a,b)	字典对比
48	ArrComp(a,b,partialComp=false)	数组对比
49	ARemove(a,b)	在数组 a 中删除 b 中相应的元素
50	AReplace(a,b,c)	在数组 a 中将匹配 b 的元素替换为 c 中相应的元素
51	A2Replace(a,b,c)	在二维数组 a 中将匹配 b 的元素替换为 c 中相应的元素
52	A2Remove(a,b,n=-1)	在二维数组 a 中删除 n 列中 b 中相应的元素所在的行，如果 n 为 -1 则删除所有相应的元素相应的行
53	DRemove(a,b)	在字典 a 中删除 b 中相应的键
54	TrySetText(text,target,a=300,b=200,times=10,desc="",causeErr=true)	尝试设置目标界面元素的文本。参数 text：要设置的文本；参数 target：界面元素目标；参数 a：执行后延迟；参数 b：执行前延迟；参数 times：尝试次数；参数 desc：目标的描述（名称），将用于抛出失败提示；参数 causeErr：是否抛出异常；返回值：如果为 0 则设置成功，大于 0 则未设置成功
55	SetText(text,target,a=300,b=200)	设置目标界面元素的文本。参数：同上
56	ATrim(a,b)	在数组 a 中删除 b 元素
57	A2Find(a,b)	在二维数组 a 中查找 b 中相应的元素的位置，返回找到的所有结果
58	ASort(a,b=false)	对数组 a 进行排序，b 为 TRUE 则从大到小排序，否则从小到大排序
59	ADeduplicate(a)	对数组 a 中的元素去重
60	A2Comp(a,b)	二维数组对比

 

@XP_151807：这个模块是我编写UiBot RPA机器人三个多月以来的成果，希望能够帮到大家。