元素截图
<p>[TOC]</p>
<h2>1.命令说明</h2>
<p>对指定元素进行全区域或者局部区域截图</p>
<h2>2.命令原型</h2>
<pre><code>WinElement.ScreenCapture(target, 'D:/test.png', rect=None, 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;">filePath</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">无</td>
<td>图片存储的绝对路径。如 “D:/1.png”(支持图片保存格式:bmp、jpg、jpeg、png、gif、tif、tiff)</td>
</tr>
<tr>
<td style="text-align: left;">rect</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">dict</td>
<td style="text-align: left;">None</td>
<td>对指定界面元素截图的范围,若传None,则截取该元素的全区域。若传{"x":int,"y":int,"width":int,"height":int},则以该元素左上角位置偏移x,y的坐标为原点,根据高宽进行截图。默认None</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>截图成功返回True,否则返回False</p>
<h2>5.运行实例</h2>
<pre><code>&quot;&quot;&quot;
******************元素截图******************
入参:
target: [必选参数]拾取器获取的目标元素特征字符串或目标元素对象
filePath: [必选参数]图片存储的绝对路径。如 'D:/1.png'(支持图片保存格式:bmp、jpg、jpeg、png、gif、tif、tiff)
rect: [可选参数]对指定界面元素截图的范围,若传None,则截取该元素的全区域。若传{&quot;x&quot;:int,&quot;y&quot;:int,&quot;width&quot;:int,&quot;height&quot;:int},则以该元素左上角位置偏移x,y的坐标为原点,根据高宽进行截图。默认None
searchDelay: [可选参数]超时时间(毫秒)。默认10000
anchorsElement: [可选参数]锚点元素,从它开始找,不传则从桌面顶级元素开始找(有值可提高查找速度)。默认None
continueOnError: [可选参数]错误继续执行。默认False
delayAfter: [可选参数]执行后延时(毫秒)。默认100
delayBefore: [可选参数]执行前延时(毫秒)。默认100
出参:
截图成功返回True,否则返回False
注意事项:
无
************************************************
&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;
# 对桌面“此电脑”元素截图
captureResult = WinElement.ScreenCapture(target, 'D:/test.png', rect=None, searchDelay=10000, anchorsElement=None, continueOnError=False, delayAfter=100, delayBefore=100)
print(captureResult)</code></pre>