!PrintToFile(folder, filename, flag)
函数意义: 截屏输出到文件。
返 回 值: 浮点数
= 0,表示执行成功
= -1021,表示没有插入U盘
参 数: (1)folder,字符串,文件夹路径,当文件夹路径以“$MCGS_DIR_USER/”字符开始时,表示存储路径为TPC的用户自定义分区,以其它字符开始则为U盘目录,路径不存在则创建。多级路径用 / 分隔,如 路径1/路径2。文件夹名称不能包含“*”、“\”、“/”、“:”、“<”、“>”、“?”、“|”、引号、“../”。
(2)filename,字符串,文件名。filename不能包含“*”、“/”、“\”、“:”、“<”、“>”、“?”、“|”。
(3)flag,整数,输出格式;0表示jpg,1表示bmp,2表示png,其它值默认输出jpg。
实 例: !PrintToFile("Folder","Name", 0)。截屏内容保存为Name.jpg文件,存储到U盘的Folder目录下。!PrintToFile("$MCGS_DIR_USER/Folder","Name", 0)。截屏内容保存为Name.jpg文件,存储到TPC的用户自定义分区的Folder目录下。
注意事项:
(1)循环策略,窗口循环脚本,后台任务中调用此函数,时间间隔不低于1秒。调用此函数后,截屏的图片输出有延时,立即断电可能会保存失败;如果图片输出到U盘,但没有插入U盘,则图片不会输出。当执行函数5秒后,系统输出文件到U盘,不能立即拔出U盘。
(2)当路径或者文件以英文字符开始时,如果U盘中存在仅有大小写区分的内容相同的路径或者文件,则创建失败。如:“a”与“A”,“a中文”与“A中文”,“a.jpg”与“A.jpg”,“a中文.jpg”与“A中文.jpg”,截屏输出失败。