鼠标移动到文本上

命令说明

按照规则搜索含有指定字符串的界面元素并将鼠标移动到这个界面元素上，鼠标停留位置为查找到的文本位置

命令原型

Text.Hover(objUiElement,sText,iRule,iOccurrence,iTimeOut,optionArgs)

命令参数

参数	必选	类型	默认值	说明
objUiElement	True	decorator	@ui""	需要查找文本的父元素，程序会在这个元素内查找文本操作，当属性传递为 字符串 类型时，作为特征串查找界面元素后查找子元素，当属性传递为 UiElement 类型时，直接在这个 UiElement 元素中进行查找，如果传递为 null，则在所有窗口中查找
sText	True	string	""	查找元素时使用的文本
iRule	True	enum	"instr"	查找文本时使用的规则
iOccurrence	True	number	1	如果“文本”字段中的字符串在指示的界面元素中出现多次，请在此处指定要单击的出现次数。例如，如果字符串出现4次并且您要单击第一个匹配项，请在此字段中写入1
iTimeOut	True	number	10000	指定在SelectorNotFoundException引发异常之前等待活动运行的时间量（以毫秒为单位）。默认值为10000毫秒（10秒）
bContinueOnError	False	boolean	False	指定即使活动引发错误，自动化是否仍应继续。该字段仅支持布尔值（True，False）。默认值为False
iDelayAfter	False	number	300	执行活动后的延迟时间（以毫秒为单位）。默认时间为300毫秒
iDelayBefore	False	number	200	活动开始执行任何操作之前的延迟时间（以毫秒为单位）。默认的时间量是200毫秒
bSetForeground	False	boolean	True	进行操作之前，是否先将目标窗口激活
sCursorPosition	False	enum	"Center"	描述添加OffsetX和OffsetY属性的偏移量的光标起点。可以使用以下选项：TopLeft，TopRight，BottomLeft，BottomRight和Center。默认选项是Center
iCursorOffsetX	False	number	10	根据在“位置”字段中选择的选项，光标位置的水平位移
iCursorOffsetY	False	number	10	根据在“位置”字段中选择的选项，光标位置的垂直位移
sKeyModifiers	False	set	[]	触发鼠标动作时同时按下的键盘按键，可以使用以下选项：Alt，Ctrl，Shift，Win
sSimulate	False	enum	"simulate"	可选择操作类型为：后台操作(uia)、模拟操作(simulate)、系统消息(message)，默认选择：模拟操作(simulate)

运行实例

/*********************************鼠标移动到文本上***************************************
命令原型：
     Text.Hover(@ui"","","instr",1,10000,{"bContinueOnError":false,"iDelayAfter":300,"iDelayBefore":200,"bSetForeground":true,"sCursorPosition":"Center","iCursorOffsetX":10,"iCursorOffsetY":10,"sKeyModifiers":[],"sSimulate":"simulate"})
入参：
     objUiElement--识别目标。
     sText--需要在目标中查找的文本。注：查找元素时使用的文本
     iRule--查找规则。注：查找文本时使用的规则
     iOccurrence--相似结果位置。
     iTimeOut--超时时间（毫秒）。注：指定等待重试查找屏幕范围时间（以毫秒为单位），如果超出该时间，则引发错误。默认30000毫秒（30秒）
     optionArgs--可选参数(包括:错误继续执行、执行后延时、执行前延时、激活窗口、光标位置、横坐标偏移、纵坐标偏移、辅助按键、操作类型).Type:Dict
注意事项：
     1.在该命令执行时要保证目标文本页面处于打开状态，并且不要触碰鼠标，显示器分辨率变更会影响该命令的执行。
********************************************************************************/
Text.Hover(@ui"文本<span>_鼠标移动到文本上","文本","instr",1,10000,{"bContinueOnError":false,"iDelayAfter":300,"iDelayBefore":200,"bSetForeground":true,"sCursorPosition":"Center","iCursorOffsetX":10,"iCursorOffsetY":10,"sKeyModifiers":[],"sSimulate":"simulate"})

可视化样例