点击目标
<p>[TOC]</p>
<h2>1.命令说明</h2>
<p>点击目标元素</p>
<h2>2.命令原型</h2>
<pre><code>WinMouse.Action(target, button=&quot;left&quot;, clickType=&quot;click&quot;, searchDelay=10000, anchorsElement=None, continueOnError=False, delayAfter=100, delayBefore=100, setForeground=True, cursorPosition='center', cursorOffsetX=0, cursorOffsetY=0, keyModifiers=None, simulateType='simulate', moveSmoothly=False)</code></pre>
<h2>3.命令参数</h2>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">默认值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">target</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string/uia.Control</td>
<td style="text-align: left;">无</td>
<td>tdRPA拾取器获取的目标元素特征字符串或uia目标元素对象</td>
</tr>
<tr>
<td style="text-align: left;">button</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">“left”</td>
<td>鼠标左键:“left” 鼠标右键:“right” 鼠标中键:“middle”</td>
</tr>
<tr>
<td style="text-align: left;">clickType</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">“click”</td>
<td>点击类型。单击:“click” 双击:“dbclick” 按下:“down” 弹起:“up”</td>
</tr>
<tr>
<td style="text-align: left;">searchDelay</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">10000</td>
<td>搜索元素的超时时间(毫秒)。默认值为10000毫秒(10秒)</td>
</tr>
<tr>
<td style="text-align: left;">anchorsElement</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">uia.Control</td>
<td style="text-align: left;">None</td>
<td>锚点元素,从它开始找,不传则从桌面顶级元素开始找(有值可提高查找速度)</td>
</tr>
<tr>
<td style="text-align: left;">continueOnError</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">bool</td>
<td style="text-align: left;">False</td>
<td>指定即使活动引发错误,自动化是否仍应继续。该字段仅支持布尔值(True,False)。默认值为False</td>
</tr>
<tr>
<td style="text-align: left;">delayAfter</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">100</td>
<td>执行活动后的延迟时间(以毫秒为单位)。默认时间为100毫秒</td>
</tr>
<tr>
<td style="text-align: left;">delayBefore</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">100</td>
<td>活动开始执行任何操作之前的延迟时间(以毫秒为单位)。默认的时间量是100毫秒</td>
</tr>
<tr>
<td style="text-align: left;">setForeground</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">bool</td>
<td style="text-align: left;">True</td>
<td>进行操作之前,是否先将目标窗口激活</td>
</tr>
<tr>
<td style="text-align: left;">cursorPosition</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">“center”</td>
<td>描述添加cursorOffsetX和cursorOffsetY属性的偏移量的光标起点。中心:“center” 左上角:“topLeft” 右上角:“topRight” 左下角:“bottomLeft” 右下角:“bottomRight”。默认“center”</td>
</tr>
<tr>
<td style="text-align: left;">cursorOffsetX</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">0</td>
<td>根据在“cursorPosition”字段中选择的选项,光标位置的水平位移。默认0</td>
</tr>
<tr>
<td style="text-align: left;">cursorOffsetY</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">0</td>
<td>根据在“cursorPosition”字段中选择的选项,光标位置的垂直位移。默认0</td>
</tr>
<tr>
<td style="text-align: left;">keyModifiers</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">list</td>
<td style="text-align: left;">None</td>
<td>辅助按键,触发鼠标动作时同时按下的键盘按键,可多选,例如:[“Alt”,“Ctrl”,“Shift”,“Win”]</td>
</tr>
<tr>
<td style="text-align: left;">simulateType</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">“simulate”</td>
<td>操作类型。模拟操作:“simulate” 消息操作:“message”</td>
</tr>
<tr>
<td style="text-align: left;">moveSmoothly</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">bool</td>
<td style="text-align: left;">False</td>
<td>是否平滑移动鼠标</td>
</tr>
</tbody>
</table>
<h2>4.返回结果</h2>
<p>目标元素对象(可作为其他命令的target或anchorsElement字段的参数值)</p>
<h2>5.运行实例</h2>
<pre><code>&quot;&quot;&quot;
****************点击目标元素****************
入参:
target: [必选参数]拾取器获取的目标元素特征字符串或目标元素对象
button: [可选参数]鼠标点击。鼠标左键:'left' 鼠标右键:'right' 鼠标中键:'middle'。默认'left'
clickType: [可选参数]点击类型。单击:'click' 双击:'dbclick' 按下:'down' 弹起:'up'。默认'click'
searchDelay: [可选参数]超时时间(毫秒)。默认10000
anchorsElement: [可选参数]锚点元素,从它开始找,不传则从桌面顶级元素开始找(有值可提高查找速度)。默认None
continueOnError: [可选参数]错误继续执行。默认False
delayAfter: [可选参数]执行后延时(毫秒)。默认100
delayBefore: [可选参数]执行前延时(毫秒)。默认100
setForeground: [可选参数]激活窗口。默认True
cursorPosition: [可选参数]光标位置。中心:'center' 左上角:'topLeft' 右上角:'topRight' 左下角:'bottomLeft' 右下角:'bottomRight'。默认'center'
cursorOffsetX: [可选参数]横坐标偏移。默认0
cursorOffsetY: [可选参数]纵坐标偏移。默认0
keyModifiers: [可选参数]辅助按键['Alt','Ctrl','Shift','Win']可多选。默认None
simulateType: [可选参数]操作类型。模拟操作:'simulate' 消息操作:'message'。默认'simulate'
moveSmoothly: [可选参数]是否平滑移动鼠标。默认False
出参:
目标元素对象
注意事项:
模拟操作:指通过调用系统api mouseevent等实现鼠标操作,会实际移动光标。
消息操作:指发送鼠标消息到目标元素,不移动光标。
*******************************************
&quot;&quot;&quot;
target = &quot;[ { 'wnd' : [ ('Text' , 'Program Manager') , ('aaRole' , '10') , ('App' , 'explorer.exe') ] } , { 'ctrl' : [ ('aaRole' , '10') ] } , { 'ctrl' : [ ('AutomationId' , '1') , ('Text' , '桌面') ] } , { 'ctrl' : [ ('Text' , '此电脑') , ('aaRole' , '34') ] }]&quot;
# 鼠标左键单击目标元素
WinMouse.Action(target, button=&quot;left&quot;, clickType=&quot;click&quot;, searchDelay=10000, anchorsElement=None, continueOnError=False, delayAfter=100, delayBefore=100, setForeground=True, cursorPosition='center', cursorOffsetX=0, cursorOffsetY=0, keyModifiers=None, simulateType='simulate', moveSmoothly=False)</code></pre>