依据tdRPA拾取特征码查找元素
<p>[TOC]</p>
<h2>1.命令说明</h2>
<p>此命令仅限使用tdRPA拾取器时使用,获取元素特征码字符串,通过此命令寻找目标元素对象</p>
<h2>2.命令原型</h2>
<pre><code>WinElement.FindElementByTd('', anchorsElement=None, searchDelay=10000, continueOnError=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;">tdTargetStr</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">无</td>
<td>tdRPA拾取器获取的目标元素特征字符串</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;">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;">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>
</tbody>
</table>
<h2>4.返回结果</h2>
<p>目标元素对象(可作为其他命令的target或anchorsElement字段的参数值),未找到则返回None</p>
<h2>5.运行实例</h2>
<pre><code>&quot;&quot;&quot;
********依据tdRPA拾取特征码查找元素********
入参:
tdTargetStr: 目标元素特征码(tdrpa拾取器获取)
anchorsElement: 从哪个元素开始找,不传则从桌面顶级元素开始找(有值可提高查找速度)
searchDelay: 查找延时(豪秒)。默认10000
continueOnError: 错误继续执行。默认False
出参:
目标元素对象
注意事项:
此命令的使用场景往往是:需要确认某锚点参数(anchorsElement)时使用,常规情况下无需此方法。
*******************************************
&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;
# 查找桌面“此电脑”的对象
uiaControl = WinElement.FindElementByTd(target, anchorsElement=None, searchDelay=10000, continueOnError=False)
print(uiaControl)</code></pre>