tdrpa.tdworker

数字员工的命令工具包


获取元素选择

<p>[TOC]</p> <h2>1.命令说明</h2> <p>获取元素的选择(可以操作 列表框、下拉列表框 等类型的元素)</p> <h2>2.命令原型</h2> <pre><code>WinElement.GetSelect(target, mode='text', searchDelay=10000, anchorsElement=None, continueOnError=False, delayAfter=100, delayBefore=100)</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;">mode</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td style="text-align: left;">“text”</td> <td>获取方式,传递为“index”时按照索引顺序获取(从0开始),传递为“text”时按照选项文本获取,传递为“value”时,按照选项的“value”属性获取</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> </tbody> </table> <h2>4.返回结果</h2> <p>已选项的文本或序号或值,没有则返回None</p> <h2>5.运行实例</h2> <pre><code>&amp;quot;&amp;quot;&amp;quot; ******************获取元素选择****************** 入参: target: [必选参数]拾取器获取的目标元素特征字符串或目标元素对象 mode: [可选参数]获取文本:&amp;quot;text&amp;quot; 获取序号:“index” 获取值:“value”。默认&amp;quot;text&amp;quot; searchDelay: [可选参数]超时时间(毫秒)。默认10000 anchorsElement: [可选参数]锚点元素,从它开始找,不传则从桌面顶级元素开始找(有值可提高查找速度)。默认None continueOnError: [可选参数]错误继续执行。默认False delayAfter: [可选参数]执行后延时(毫秒)。默认100 delayBefore: [可选参数]执行前延时(毫秒)。默认100 出参: 已选项的文本或序号或值,没有则返回None 注意事项: 无 ************************************************ &amp;quot;&amp;quot;&amp;quot; target = &amp;quot;[ { 'wnd' : [ ('Text' , '窗体1') , ('aaRole' , '10') , ('App' , '*.exe' , 'fuzz') ] } , { 'ctrl' : [ ('Text' , '窗体1') , ('aaRole' , '18') ] } , { 'ctrl' : [ ('ControlType' , 'ComboBox') , ('AutomationId' , '10000') , ('ClassName' , 'ComboBox') ] }]&amp;quot; # 获取元素选择 selectedItemText = WinElement.GetSelect(target, mode='text', searchDelay=10000, anchorsElement=None, continueOnError=False, delayAfter=100, delayBefore=100) print(selectedItemText)</code></pre>

页面列表

ITEM_HTML