<spanid="module-robot-uidesktop"></span><h1>2. Функции UIDesktop<aclass="headerlink"href="#uidesktop"title="Ссылка на этот заголовок">¶</a></h1>
<divclass="section"id="id1">
<h2>Общее<aclass="headerlink"href="#id1"title="Ссылка на этот заголовок">¶</a></h2>
<p>Здесь представлено описание всех функций, которые используются для взаимодействия с UI интерфейсами локальных приложений.</p>
<p><strong>Функции в модуле UIDesktop именуются по следующему принципу:</strong>
<Входящий аргумент>_<действие>_<исходящий аргумент - если присутствует></p>
<p><strong>Термины и определения:</strong></p>
<ulclass="simple">
<li><p><strong>UIO:</strong> Объект пользовательского интерфейса</p></li>
<li><p><strong>UIOSelector:</strong> Селектор (адрес) одного и/или более UIO объектов. Селектор представлен в формате списка (list) словарей (dict) атрибутивных критериев.</p></li>
<td><p>Получить список UIOInfo словарей - процессы, которые запущены в рабочей сессии и готовы для взаимодействия с роботом через backend inBackend</p></td>
<td><p>Установить фокус и подсветить на несколько секунд на экране зеленой рамкой UIO объект, который соответствует входящему UIO селектору inUIOSelector</p></td>
<td><p>Техническая функция: Получить список параметров последних уровней UIO селектора по UIO объектам, которые удовлетворяют входящим inUIOSelector, поиск по которым будет производится от уровня inElement.</p></td>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">BackendStr_GetTopLevelList_UIOInfo</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inBackend</span><spanclass="o">=</span><spanclass="default_value">'win32'</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#BackendStr_GetTopLevelList_UIOInfo"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.BackendStr_GetTopLevelList_UIOInfo"title="Ссылка на это определение">¶</a></dt>
<dd><p>Получить список UIOInfo словарей - процессы, которые запущены в рабочей сессии и готовы для взаимодействия с роботом через backend inBackend</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<spanclass="n">lAppList</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">BackendStr_GetTopLevelList_UIOInfo</span><spanclass="p">()</span><spanclass="c1"># Очистить UIO селектор от недопустимых ключей для дальнейшего использования</span>
</pre></div>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Параметры</dt>
<ddclass="field-odd"><p><strong>inBackend</strong> (<em>list</em><em>, </em><em>обязательный</em>) – вид backend, который планируется использовать для взаимодействия с UIO объектами</p>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">Get_OSBitnessInt</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#Get_OSBitnessInt"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.Get_OSBitnessInt"title="Ссылка на это определение">¶</a></dt>
<spanclass="n">lRobotBitInt</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">Get_OSBitnessInt</span><spanclass="p">()</span><spanclass="c1"># Определить разрядность робота, в котором была вызвана это функция</span>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">PWASpecification_Get_PWAApplication</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inControlSpecificationArray</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#PWASpecification_Get_PWAApplication"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.PWASpecification_Get_PWAApplication"title="Ссылка на это определение">¶</a></dt>
<dd><p>Получить значение атрибута backend по PWA (pywinauto) селектору. Мы рекомендуем использовать метод UIOSelector_UIO_Get, так как UIO селектор обладает большей функциональностью.</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<spanclass="n">lBackendStr</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">PWASpecification_Get_PWAApplication</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1"># Получить backend по PWA селектору</span>
<ddclass="field-odd"><p><strong>inControlSpecificationArray</strong> (<em>list</em><em>, </em><em>обязательный</em>) –<p>PWA селектор, который определяет критерии поиска UIO объекта
Допустимые ключи PWA селектора:</p>
<ulclass="simple">
<li><p>class_name содержимое атрибута class UIO объекта</p></li>
<li><p>class_name_re содержимое атрибута class UIO объекта, которое удовлетворяет установленному рег. выражению</p></li>
<li><p>process идентификатор процесса, в котором находится UIO объект</p></li>
<li><p>title содержимое атрибута title UIO объекта</p></li>
<li><p>title_re содержимое атрибута title UIO объекта, которое удовлетворяет установленному рег. выражению</p></li>
<li><p>top_level_only признак поиска только на верхнем уровне приложения. По умолчанию True</p></li>
<li><p>visible_only признак поиска только среди видимых UIO объектов. По умолчанию True</p></li>
<li><p>enabled_only признак поиска только среди разблокированных UIO объектов. По умолчанию False</p></li>
<li><p>best_match содержимое атрибута title UIO объекта максимально приближено к заданному</p></li>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">PWASpecification_Get_UIO</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inControlSpecificationArray</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#PWASpecification_Get_UIO"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.PWASpecification_Get_UIO"title="Ссылка на это определение">¶</a></dt>
<dd><p>Получить UIO объект по PWA (pywinauto) селектору. (<aclass="reference external"href="https://pywinauto.readthedocs.io/en/latest/code/pywinauto.findwindows.html">https://pywinauto.readthedocs.io/en/latest/code/pywinauto.findwindows.html</a>). Мы рекомендуем использовать метод UIOSelector_UIO_Get, так как UIO селектор обладает большей функциональностью.</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<spanclass="n">lUIOObject</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">PWASpecification_Get_UIO</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1"># Получить UIO объект по PWA селектору</span>
</pre></div>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Параметры</dt>
<ddclass="field-odd"><p><strong>inControlSpecificationArray</strong> (<em>list</em><em>, </em><em>обязательный</em>) –<p>PWA селектор, который определяет критерии поиска UIO объекта
Допустимые ключи PWA селектора:</p>
<ulclass="simple">
<li><p>class_name содержимое атрибута class UIO объекта</p></li>
<li><p>class_name_re содержимое атрибута class UIO объекта, которое удовлетворяет установленному рег. выражению</p></li>
<li><p>process идентификатор процесса, в котором находится UIO объект</p></li>
<li><p>title содержимое атрибута title UIO объекта</p></li>
<li><p>title_re содержимое атрибута title UIO объекта, которое удовлетворяет установленному рег. выражению</p></li>
<li><p>top_level_only признак поиска только на верхнем уровне приложения. По умолчанию True</p></li>
<li><p>visible_only признак поиска только среди видимых UIO объектов. По умолчанию True</p></li>
<li><p>enabled_only признак поиска только среди разблокированных UIO объектов. По умолчанию False</p></li>
<li><p>best_match содержимое атрибута title UIO объекта максимально приближено к заданному</p></li>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOEI_Convert_UIOInfo</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inElementInfo</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOEI_Convert_UIOInfo"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOEI_Convert_UIOInfo"title="Ссылка на это определение">¶</a></dt>
<dd><p>Техническая функция: Дообогащение словаря с параметрами UIO объекта по заданному UIO.element_info</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<spanclass="n">lUIO</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_Get_UIO</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1"># Получить UIO объект по UIO селектору.</span>
<ddclass="field-odd"><p><strong>inElementInfo</strong> (<em>object</em><em>, </em><em>обязательный</em>) – экземпляр класса UIO.element_info, для которого требуется дообогатить словарь с параметрами (в дальнейшем можно использовать как элемент UIO селектора).</p>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOSelectorSecs_WaitAppear_Bool</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inSpecificationList</span></em>, <emclass="sig-param"><spanclass="n">inWaitSecs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOSelectorSecs_WaitAppear_Bool"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOSelectorSecs_WaitAppear_Bool"title="Ссылка на это определение">¶</a></dt>
<dd><p>Ожидать появление 1-го UIO объекта по заданному UIO селектору</p>
<p>!ВНИМАНИЕ! ДАННАЯ ФУНКЦИОНАЛЬНОСТЬ В АВТОМАТИЧЕСКОМ РЕЖИМЕ ПОДДЕРЖИВАЕТ ВСЕ РАЗРЯДНОСТИ ПРИЛОЖЕНИЙ (32|64), КОТОРЫЕ ЗАПУЩЕНЫ В СЕСИИ. PYTHON x64 ИМЕЕТ ВОЗМОЖНОСТЬ ВЗЗАИМОДЕЙСТВИЯ С x32 UIO ОБЪЕКТАМИ, НО МЫ РЕКОМЕНДУЕМ ДОПОЛНИТЕЛЬНО ИСПОЛЬЗОВАТЬ ИНТЕРПРЕТАТОР PYTHON x32 (ПОДРОБНЕЕ СМ. ФУНКЦИЮ Configure())</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<spanclass="n">lDemoBaseUIOExistBool</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelectorSecs_WaitAppear_Bool</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1"># Ожидать появление UIO объекта</span>
<li><p><strong>inSpecificationList</strong> (<em>list</em><em>, </em><em>обязательный</em>) – UIO селектор, который определяет критерии поиска UIO объекта</p></li>
<li><p><strong>inWaitSecs</strong> (<em>float</em><em>, </em><em>необязательный</em>) – Количество секунд, которые отвести на ожидание UIO объекта. По умолчанию 24 часа (86400 секунд)</p></li>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOSelectorSecs_WaitDisappear_Bool</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inSpecificationList</span></em>, <emclass="sig-param"><spanclass="n">inWaitSecs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOSelectorSecs_WaitDisappear_Bool"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOSelectorSecs_WaitDisappear_Bool"title="Ссылка на это определение">¶</a></dt>
<dd><p>Ожидать исчезновение 1-го UIO объекта по заданному UIO селектору</p>
<p>!ВНИМАНИЕ! ДАННАЯ ФУНКЦИОНАЛЬНОСТЬ В АВТОМАТИЧЕСКОМ РЕЖИМЕ ПОДДЕРЖИВАЕТ ВСЕ РАЗРЯДНОСТИ ПРИЛОЖЕНИЙ (32|64), КОТОРЫЕ ЗАПУЩЕНЫ В СЕСИИ. PYTHON x64 ИМЕЕТ ВОЗМОЖНОСТЬ ВЗЗАИМОДЕЙСТВИЯ С x32 UIO ОБЪЕКТАМИ, НО МЫ РЕКОМЕНДУЕМ ДОПОЛНИТЕЛЬНО ИСПОЛЬЗОВАТЬ ИНТЕРПРЕТАТОР PYTHON x32 (ПОДРОБНЕЕ СМ. ФУНКЦИЮ Configure())</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<li><p><strong>inSpecificationList</strong> (<em>list</em><em>, </em><em>обязательный</em>) – UIO селектор, который определяет критерии поиска UIO объекта</p></li>
<li><p><strong>inWaitSecs</strong> (<em>float</em><em>, </em><em>необязательный</em>) – Количество секунд, которые отвести на исчезновение UIO объекта. По умолчанию 24 часа (86400 секунд)</p></li>
<dd><p>Выполнить активность inActionName над UIO объектом, полученным с помощью UIO селектора inUIOSelector. Описание возможных активностей см. ниже.</p>
<p>!ВНИМАНИЕ! ДАННАЯ ФУНКЦИОНАЛЬНОСТЬ В АВТОМАТИЧЕСКОМ РЕЖИМЕ ПОДДЕРЖИВАЕТ ВСЕ РАЗРЯДНОСТИ ПРИЛОЖЕНИЙ (32|64), КОТОРЫЕ ЗАПУЩЕНЫ В СЕСИИ. PYTHON x64 ИМЕЕТ ВОЗМОЖНОСТЬ ВЗЗАИМОДЕЙСТВИЯ С x32 UIO ОБЪЕКТАМИ, НО МЫ РЕКОМЕНДУЕМ ДОПОЛНИТЕЛЬНО ИСПОЛЬЗОВАТЬ ИНТЕРПРЕТАТОР PYTHON x32 (ПОДРОБНЕЕ СМ. ФУНКЦИЮ Configure())</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<spanclass="n">lActivityResult</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelectorUIOActivity_Run_Dict</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">,</span><spanclass="s2">"click"</span><spanclass="p">)</span><spanclass="c1"># выполнить действие над UIO объектом с помощью UIO селектора.</span>
<li><p><strong>inUIOSelector</strong> (<em>list</em><em>, </em><em>обязательный</em>) – UIO селектор, который определяет UIO объект, для которого будет представлен перечень доступных активностей.</p></li>
<li><p><strong>inActionName</strong> (<em>str</em><em>, </em><em>обязательный</em>) – наименование активности, которую требуется выполнить над UIO объектом</p></li>
<li><p><strong>inArgumentList</strong> (<em>list</em><em>, </em><em>необязательный</em>) – список передаваемых неименованных аргументов в функцию inActionName</p></li>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOSelector_Exist_Bool</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inUIOSelector</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOSelector_Exist_Bool"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOSelector_Exist_Bool"title="Ссылка на это определение">¶</a></dt>
<dd><p>Проверить существование хотя бы 1-го UIO объекта по заданному UIO селектору</p>
<p>!ВНИМАНИЕ! ДАННАЯ ФУНКЦИОНАЛЬНОСТЬ В АВТОМАТИЧЕСКОМ РЕЖИМЕ ПОДДЕРЖИВАЕТ ВСЕ РАЗРЯДНОСТИ ПРИЛОЖЕНИЙ (32|64), КОТОРЫЕ ЗАПУЩЕНЫ В СЕСИИ. PYTHON x64 ИМЕЕТ ВОЗМОЖНОСТЬ ВЗЗАИМОДЕЙСТВИЯ С x32 UIO ОБЪЕКТАМИ, НО МЫ РЕКОМЕНДУЕМ ДОПОЛНИТЕЛЬНО ИСПОЛЬЗОВАТЬ ИНТЕРПРЕТАТОР PYTHON x32 (ПОДРОБНЕЕ СМ. ФУНКЦИЮ Configure())</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<spanclass="n">lDemoBaseUIOExistBool</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_Exist_Bool</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1"># Получить булевый результат проверки существования UIO объекта</span>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOSelector_FocusHighlight</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inUIOSelector</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOSelector_FocusHighlight"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOSelector_FocusHighlight"title="Ссылка на это определение">¶</a></dt>
<dd><p>Установить фокус и подсветить на несколько секунд на экране зеленой рамкой UIO объект, который соответствует входящему UIO селектору inUIOSelector</p>
<p>!ВНИМАНИЕ! ДАННАЯ ФУНКЦИОНАЛЬНОСТЬ В АВТОМАТИЧЕСКОМ РЕЖИМЕ ПОДДЕРЖИВАЕТ ВСЕ РАЗРЯДНОСТИ ПРИЛОЖЕНИЙ (32|64), КОТОРЫЕ ЗАПУЩЕНЫ В СЕСИИ. PYTHON x64 ИМЕЕТ ВОЗМОЖНОСТЬ ВЗЗАИМОДЕЙСТВИЯ С x32 UIO ОБЪЕКТАМИ, НО МЫ РЕКОМЕНДУЕМ ДОПОЛНИТЕЛЬНО ИСПОЛЬЗОВАТЬ ИНТЕРПРЕТАТОР PYTHON x32 (ПОДРОБНЕЕ СМ. ФУНКЦИЮ Configure())</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_FocusHighlight</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1"># Установить фокус и подсветить UIO объект по UIO селектору</span>
<ddclass="field-odd"><p><strong>inUIOSelector</strong> (<em>list</em><em>, </em><em>обязательный</em>) – UIO селектор, который определяет UIO объект, для которого будет представлен перечень доступных активностей.</p>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOSelector_GetChildList_UIOList</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inUIOSelector</span><spanclass="o">=</span><spanclass="default_value">None</span></em>, <emclass="sig-param"><spanclass="n">inBackend</span><spanclass="o">=</span><spanclass="default_value">'win32'</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOSelector_GetChildList_UIOList"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOSelector_GetChildList_UIOList"title="Ссылка на это определение">¶</a></dt>
<dd><p>Получить список дочерних UIO объектов по входящему UIO селектору inUIOSelector.</p>
<p>!ВНИМАНИЕ! ДАННАЯ ФУНКЦИОНАЛЬНОСТЬ В АВТОМАТИЧЕСКОМ РЕЖИМЕ ПОДДЕРЖИВАЕТ ВСЕ РАЗРЯДНОСТИ ПРИЛОЖЕНИЙ (32|64), КОТОРЫЕ ЗАПУЩЕНЫ В СЕСИИ. PYTHON x64 ИМЕЕТ ВОЗМОЖНОСТЬ ВЗЗАИМОДЕЙСТВИЯ С x32 UIO ОБЪЕКТАМИ, НО МЫ РЕКОМЕНДУЕМ ДОПОЛНИТЕЛЬНО ИСПОЛЬЗОВАТЬ ИНТЕРПРЕТАТОР PYTHON x32 (ПОДРОБНЕЕ СМ. ФУНКЦИЮ Configure())</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<spanclass="n">lUIOList</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_GetChildList_UIOList</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1"># Получить список дочерних UIO объектов с помощью UIO селектора</span>
<li><p><strong>inUIOSelector</strong> (<em>list</em><em>, </em><em>обязательный</em>) – родительский UIO объект, полученный ранее с помощью UIO селектора.</p></li>
<li><p><strong>inBackend</strong> (<em>str</em><em>, </em><em>необязательный</em>) – вид backend «win32» или «uia». По умолчанию mDefaultPywinautoBackend («win32»)</p></li>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOSelector_Get_BitnessInt</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inSpecificationList</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOSelector_Get_BitnessInt"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOSelector_Get_BitnessInt"title="Ссылка на это определение">¶</a></dt>
<spanclass="n">lDemoBaseBitInt</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_Get_BitnessInt</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1"># Определить разрядность приложения, в котором обнаружен UIO объект по селектору</span>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOSelector_Get_BitnessStr</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inSpecificationList</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOSelector_Get_BitnessStr"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOSelector_Get_BitnessStr"title="Ссылка на это определение">¶</a></dt>
<spanclass="n">lDemoBaseBitStr</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_Get_BitnessStr</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1"># Определить разрядность приложения, в котором обнаружен UIO объект по селектору</span>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOSelector_Get_UIO</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inSpecificationList</span></em>, <emclass="sig-param"><spanclass="n">inElement</span><spanclass="o">=</span><spanclass="default_value">None</span></em>, <emclass="sig-param"><spanclass="n">inFlagRaiseException</span><spanclass="o">=</span><spanclass="default_value">True</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOSelector_Get_UIO"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOSelector_Get_UIO"title="Ссылка на это определение">¶</a></dt>
<spanclass="n">lDemoBaseUIOList</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_Get_UIO</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1">#Получить 1-й UIO объект, которые удовлетворяет требованиям UIO селектора. В нашем примере либо None, либо UIO объект</span>
<li><p><strong>inSpecificationList</strong> (<em>list</em><em>, </em><em>обязательный</em>) – UIO Селектор, который определяет критерии поиска UI элементов</p></li>
<li><p><strong>inElement</strong> (<em>UIO объект</em><em>, </em><em>опциональный</em>) – Родительский элемент, от которого выполнить поиск UIO объектов по заданному UIO селектору. Если аргумент не задан, платформа выполнит поиск UIO объектов среди всех доступных приложений windows, которые запущены на текущей сессии</p></li>
<li><p><strong>inFlagRaiseException</strong> (<em>bool</em><em>, </em><em>опциональный</em>) – True - формировать ошибку exception, если платформа не обнаружина ни одного UIO объекта по заданному UIO селектору. False - обратный случай. По умолчанию True</p></li>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOSelector_Get_UIOActivityList</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inUIOSelector</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOSelector_Get_UIOActivityList"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOSelector_Get_UIOActivityList"title="Ссылка на это определение">¶</a></dt>
<dd><p>Получить список доступных действий/функций по UIO селектору inUIOSelector. Описание возможных активностей см. ниже.</p>
<p>!ВНИМАНИЕ! ДАННАЯ ФУНКЦИОНАЛЬНОСТЬ В АВТОМАТИЧЕСКОМ РЕЖИМЕ ПОДДЕРЖИВАЕТ ВСЕ РАЗРЯДНОСТИ ПРИЛОЖЕНИЙ (32|64), КОТОРЫЕ ЗАПУЩЕНЫ В СЕСИИ. PYTHON x64 ИМЕЕТ ВОЗМОЖНОСТЬ ВЗЗАИМОДЕЙСТВИЯ С x32 UIO ОБЪЕКТАМИ, НО МЫ РЕКОМЕНДУЕМ ДОПОЛНИТЕЛЬНО ИСПОЛЬЗОВАТЬ ИНТЕРПРЕТАТОР PYTHON x32 (ПОДРОБНЕЕ СМ. ФУНКЦИЮ Configure())</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<spanclass="n">lActivityList</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_Get_UIOActivityList</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1"># Получить список активностей по UIO селектору.</span>
<ddclass="field-odd"><p><strong>inUIOSelector</strong> (<em>list</em><em>, </em><em>обязательный</em>) – UIO селектор, который определяет UIO объект, для которого будет представлен перечень доступных активностей.</p>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOSelector_Get_UIOInfo</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inUIOSelector</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOSelector_Get_UIOInfo"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOSelector_Get_UIOInfo"title="Ссылка на это определение">¶</a></dt>
<dd><p>Получить свойства UIO объекта (element_info), по заданному UIO селектору. Ниже представлен перечень возвращаемых свойств.</p>
<p>Для backend = win32:</p>
<ulclass="simple">
<li><p>automation_id (int)</p></li>
<li><p>class_name (str)</p></li>
<li><p>control_id (int)</p></li>
<li><p>control_type (str)</p></li>
<li><p>full_control_type (str)</p></li>
<li><p>enabled (bool)</p></li>
<li><p>handle (int)</p></li>
<li><p>name (str)</p></li>
<li><p>parent (object/UIO)</p></li>
<li><p>process_id (int)</p></li>
<li><p>rectangle (object/rect)</p></li>
<li><p>rich_text (str)</p></li>
<li><p>visible (bool)</p></li>
</ul>
<p>Для backend = uia:</p>
<ulclass="simple">
<li><p>automation_id (int)</p></li>
<li><p>class_name (str)</p></li>
<li><p>control_id (int)</p></li>
<li><p>control_type (str)</p></li>
<li><p>enabled (bool)</p></li>
<li><p>framework_id (int)</p></li>
<li><p>handle (int)</p></li>
<li><p>name (str)</p></li>
<li><p>parent (object/UIO)</p></li>
<li><p>process_id (int)</p></li>
<li><p>rectangle (object/rect)</p></li>
<li><p>rich_text (str)</p></li>
<li><p>runtime_id (int)</p></li>
<li><p>visible (bool)</p></li>
</ul>
<p>!ВНИМАНИЕ! ДАННАЯ ФУНКЦИОНАЛЬНОСТЬ В АВТОМАТИЧЕСКОМ РЕЖИМЕ ПОДДЕРЖИВАЕТ ВСЕ РАЗРЯДНОСТИ ПРИЛОЖЕНИЙ (32|64), КОТОРЫЕ ЗАПУЩЕНЫ В СЕСИИ. PYTHON x64 ИМЕЕТ ВОЗМОЖНОСТЬ ВЗЗАИМОДЕЙСТВИЯ С x32 UIO ОБЪЕКТАМИ, НО МЫ РЕКОМЕНДУЕМ ДОПОЛНИТЕЛЬНО ИСПОЛЬЗОВАТЬ ИНТЕРПРЕТАТОР PYTHON x32 (ПОДРОБНЕЕ СМ. ФУНКЦИЮ Configure())</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<spanclass="n">lUIOElementInfoDict</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_Get_UIOInfo</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1">#Получить свойства над UIO объектом с помощью UIO селектора.</span>
</pre></div>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Параметры</dt>
<ddclass="field-odd"><p><strong>inUIOSelector</strong> (<em>list</em><em>, </em><em>обязательный</em>) – UIO селектор, который определяет UIO объект, для которого будет представлен перечень доступных активностей.</p>
</dd>
<dtclass="field-even">Результат</dt>
<ddclass="field-even"><p>словарь свойств element_info: Пример {«control_id»: …, «process_id»: …}</p>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOSelector_Get_UIOInfoList</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inUIOSelector</span></em>, <emclass="sig-param"><spanclass="n">inElement</span><spanclass="o">=</span><spanclass="default_value">None</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOSelector_Get_UIOInfoList"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOSelector_Get_UIOInfoList"title="Ссылка на это определение">¶</a></dt>
<dd><p>Техническая функция: Получить список параметров последних уровней UIO селектора по UIO объектам, которые удовлетворяют входящим inUIOSelector, поиск по которым будет производится от уровня inElement.</p>
<p>!ВНИМАНИЕ! ДАННАЯ ФУНКЦИОНАЛЬНОСТЬ В АВТОМАТИЧЕСКОМ РЕЖИМЕ ПОДДЕРЖИВАЕТ ВСЕ РАЗРЯДНОСТИ ПРИЛОЖЕНИЙ (32|64), КОТОРЫЕ ЗАПУЩЕНЫ В СЕСИИ. PYTHON x64 ИМЕЕТ ВОЗМОЖНОСТЬ ВЗЗАИМОДЕЙСТВИЯ С x32 UIO ОБЪЕКТАМИ, НО МЫ РЕКОМЕНДУЕМ ДОПОЛНИТЕЛЬНО ИСПОЛЬЗОВАТЬ ИНТЕРПРЕТАТОР PYTHON x32 (ПОДРОБНЕЕ СМ. ФУНКЦИЮ Configure())</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<spanclass="n">lUIOInfoList</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_Get_UIOInfoList</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1"># Получить словарь параметров по UIO селектору.</span>
<li><p><strong>inUIOSelector</strong> (<em>list</em><em>, </em><em>обязательный</em>) – UIO селектор, который определяет UIO объект, для которого будет произведено извлечение всех атрибутов на всех уровнях.</p></li>
<li><p><strong>inElement</strong> (<em>UIO объект</em><em>, </em><em>необязательный</em>) – UIO объект, от которого выполнить поиск дочерних UIO объектов по UIO селектору inUIOSelector. По умолчанию None - поиск среди всех приложений.</p></li>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOSelector_Get_UIOList</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inSpecificationList</span></em>, <emclass="sig-param"><spanclass="n">inElement</span><spanclass="o">=</span><spanclass="default_value">None</span></em>, <emclass="sig-param"><spanclass="n">inFlagRaiseException</span><spanclass="o">=</span><spanclass="default_value">True</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOSelector_Get_UIOList"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOSelector_Get_UIOList"title="Ссылка на это определение">¶</a></dt>
<spanclass="n">lDemoBaseUIOList</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_Get_UIOList</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1">#Получить список UIO объектов, которые удовлетворяют требованиям UIO селектора. В нашем примере либо [], либо [UIO объект]</span>
<li><p><strong>inSpecificationList</strong> (<em>list</em><em>, </em><em>обязательный</em>) – UIO Селектор, который определяет критерии поиска UI элементов</p></li>
<li><p><strong>inElement</strong> (<em>UIO объект</em><em>, </em><em>опциональный</em>) – Родительский элемент, от которого выполнить поиск UIO объектов по заданному UIO селектору. Если аргумент не задан, платформа выполнит поиск UIO объектов среди всех доступных приложений windows, которые запущены на текущей сессии</p></li>
<li><p><strong>inFlagRaiseException</strong> (<em>bool</em><em>, </em><em>опциональный</em>) – True - формировать ошибку exception, если платформа не обнаружина ни одного UIO объекта по заданному UIO селектору. False - обратный случай. По умолчанию True</p></li>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOSelector_Highlight</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inUIOSelector</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOSelector_Highlight"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOSelector_Highlight"title="Ссылка на это определение">¶</a></dt>
<dd><p>Подсветить на несколько секунд на экране зеленой рамкой UIO объект, который соответствует входящему UIO селектору inUIOSelector</p>
<p>!ВНИМАНИЕ! ДАННАЯ ФУНКЦИОНАЛЬНОСТЬ В АВТОМАТИЧЕСКОМ РЕЖИМЕ ПОДДЕРЖИВАЕТ ВСЕ РАЗРЯДНОСТИ ПРИЛОЖЕНИЙ (32|64), КОТОРЫЕ ЗАПУЩЕНЫ В СЕСИИ. PYTHON x64 ИМЕЕТ ВОЗМОЖНОСТЬ ВЗЗАИМОДЕЙСТВИЯ С x32 UIO ОБЪЕКТАМИ, НО МЫ РЕКОМЕНДУЕМ ДОПОЛНИТЕЛЬНО ИСПОЛЬЗОВАТЬ ИНТЕРПРЕТАТОР PYTHON x32 (ПОДРОБНЕЕ СМ. ФУНКЦИЮ Configure())</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_Highlight</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1"># Подсветить UIO объект по UIO селектору</span>
<ddclass="field-odd"><p><strong>inUIOSelector</strong> (<em>list</em><em>, </em><em>обязательный</em>) – UIO селектор, который определяет UIO объект, для которого будет представлен перечень доступных активностей.</p>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOSelector_SafeOtherGet_Process</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inUIOSelector</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOSelector_SafeOtherGet_Process"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOSelector_SafeOtherGet_Process"title="Ссылка на это определение">¶</a></dt>
<dd><p>Получить процесс робота другой разрядности (если приложение UIO объекта выполняется в другой разрядности). Функция возвращает None, если разрядность робота совпадает с разрядностью приложения UIO объекта, либо если при инициализации робота не устанавливался интерпретатор другой разрядности.</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<spanclass="n">lOtherBitnessProcess</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_SafeOtherGet_Process</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1"># Вернуть процесс робота, схожей разрядности</span>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOSelector_SearchChildByMouse_UIO</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inElementSpecification</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOSelector_SearchChildByMouse_UIO"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOSelector_SearchChildByMouse_UIO"title="Ссылка на это определение">¶</a></dt>
<dd><p>Инициировать визуальный поиск UIO объекта с помощью указателя мыши. При наведении указателя мыши UIO объект выделяется зеленой рамкой. Остановить режим поиска можно с помощью зажима клавиши ctrl left на протяжении нескольких секунд. После этого в веб окне студии будет отображено дерево расположения искомого UIO объекта.</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<spanclass="n">lUIO</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_SearchChildByMouse_UIO</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1"># Инициировать поиск дочернего UIO объекта, который расположен внутри lDemoBaseUIOSelector.</span>
<ddclass="field-odd"><p><strong>inElementSpecification</strong> (<em>list</em><em>, </em><em>обязательный</em>) – UIO селектор, который определяет критерии поиска родительского UIO объекта, в котором будет производиться поиск дочернего UIO объекта</p>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOSelector_SearchChildByMouse_UIOTree</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inUIOSelector</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOSelector_SearchChildByMouse_UIOTree"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOSelector_SearchChildByMouse_UIOTree"title="Ссылка на это определение">¶</a></dt>
<dd><p>Получить список уровней UIO объекта с указнием всех имеющихся атрибутов по входящему UIO селектору.</p>
<p>!ВНИМАНИЕ! ДАННАЯ ФУНКЦИОНАЛЬНОСТЬ В АВТОМАТИЧЕСКОМ РЕЖИМЕ ПОДДЕРЖИВАЕТ ВСЕ РАЗРЯДНОСТИ ПРИЛОЖЕНИЙ (32|64), КОТОРЫЕ ЗАПУЩЕНЫ В СЕСИИ. PYTHON x64 ИМЕЕТ ВОЗМОЖНОСТЬ ВЗЗАИМОДЕЙСТВИЯ С x32 UIO ОБЪЕКТАМИ, НО МЫ РЕКОМЕНДУЕМ ДОПОЛНИТЕЛЬНО ИСПОЛЬЗОВАТЬ ИНТЕРПРЕТАТОР PYTHON x32 (ПОДРОБНЕЕ СМ. ФУНКЦИЮ Configure())</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<spanclass="n">lBackendStr</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_SearchChildByMouse_UIOTree</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1"># Получить список атрибутов всех родительских элементов lDemoBaseUIOSelector.</span>
<ddclass="field-odd"><p><strong>inUIOSelector</strong> (<em>list</em><em>, </em><em>обязательный</em>) – UIO селектор, который определяет UIO объект, для которого будет произведено извлечение всех атрибутов на всех уровнях.</p>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOSelector_SearchProcessNormalize_UIOSelector</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inControlSpecificationArray</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOSelector_SearchProcessNormalize_UIOSelector"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOSelector_SearchProcessNormalize_UIOSelector"title="Ссылка на это определение">¶</a></dt>
<dd><p>Нормализовать UIO селектор для дальнейшего использования в функциях поиска процесса, в котором находится искомый UIO объект. Если недопустимых атрибутов не присутствует, то оставить как есть.</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<spanclass="n">lDemoBaseUIOSelectorClean</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_SearchProcessNormalize_UIOSelector</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelectorDitry</span><spanclass="p">)</span><spanclass="c1"># Очистить UIO селектор от недопустимых ключей для дальнейшего использования</span>
</pre></div>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Параметры</dt>
<ddclass="field-odd"><p><strong>inControlSpecificationArray</strong> (<em>list</em><em>, </em><em>обязательный</em>) – UIO селектор, который определяет UIO объект, для которого будет представлен перечень доступных активностей.</p>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOSelector_SearchUIONormalize_UIOSelector</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inControlSpecificationArray</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOSelector_SearchUIONormalize_UIOSelector"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOSelector_SearchUIONormalize_UIOSelector"title="Ссылка на это определение">¶</a></dt>
<dd><p>Нормализовать UIO селектор для дальнейшего использования в функциях поиск UIO объекта. Если недопустимых атрибутов не присутствует, то оставить как есть.</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<spanclass="n">lDemoBaseUIOSelectorClean</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_SearchUIONormalize_UIOSelector</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelectorDitry</span><spanclass="p">)</span><spanclass="c1"># Очистить UIO селектор от недопустимых ключей для дальнейшего использования</span>
<ddclass="field-odd"><p><strong>inControlSpecificationArray</strong> (<em>list</em><em>, </em><em>обязательный</em>) – UIO селектор, который определяет UIO объект, для которого будет представлен перечень доступных активностей.</p>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOSelector_TryRestore_Dict</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inSpecificationList</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOSelector_TryRestore_Dict"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOSelector_TryRestore_Dict"title="Ссылка на это определение">¶</a></dt>
<dd><p>Восстановить окно приложения на экране по UIO селектору inSpecificationList, если оно было свернуто. Функция обернута в try .. except - ошибок не возникнет.</p>
<p>!ВНИМАНИЕ! ДАННАЯ ФУНКЦИОНАЛЬНОСТЬ УЖЕ ИСПОЛЬЗУЕТСЯ В РЯДЕ ДРУГИХ ФУНКЦИЙ ТАККАК АДРЕССАЦИЯ ПО UIA FRAMEWORK НЕДОСТУПНА, ЕСЛИ ПРИЛОЖЕНИЕ СВЕРНУТО.</p>
<p>!ВНИМАНИЕ! ДАННАЯ ФУНКЦИОНАЛЬНОСТЬ В АВТОМАТИЧЕСКОМ РЕЖИМЕ ПОДДЕРЖИВАЕТ ВСЕ РАЗРЯДНОСТИ ПРИЛОЖЕНИЙ (32|64), КОТОРЫЕ ЗАПУЩЕНЫ В СЕСИИ. PYTHON x64 ИМЕЕТ ВОЗМОЖНОСТЬ ВЗЗАИМОДЕЙСТВИЯ С x32 UIO ОБЪЕКТАМИ, НО МЫ РЕКОМЕНДУЕМ ДОПОЛНИТЕЛЬНО ИСПОЛЬЗОВАТЬ ИНТЕРПРЕТАТОР PYTHON x32 (ПОДРОБНЕЕ СМ. ФУНКЦИЮ Configure())</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_TryRestore_Dict</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1"># Попытка восстановления свернутого окна по UIO селектору.</span>
</pre></div>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Параметры</dt>
<ddclass="field-odd"><p><strong>inSpecificationList</strong> (<em>list</em><em>, </em><em>обязательный</em>) – UIO селектор, который определяет UIO объект, для которого будет произведено извлечение всех атрибутов на всех уровнях.</p>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOSelectorsSecs_WaitAppear_List</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inSpecificationListList</span></em>, <emclass="sig-param"><spanclass="n">inWaitSecs</span><spanclass="o">=</span><spanclass="default_value">86400.0</span></em>, <emclass="sig-param"><spanclass="n">inFlagWaitAllInMoment</span><spanclass="o">=</span><spanclass="default_value">False</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOSelectorsSecs_WaitAppear_List"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOSelectorsSecs_WaitAppear_List"title="Ссылка на это определение">¶</a></dt>
<dd><p>Ожидать появление хотя бы 1-го / всех UIO объектов по заданным UIO селекторам</p>
<p>!ВНИМАНИЕ! ДАННАЯ ФУНКЦИОНАЛЬНОСТЬ В АВТОМАТИЧЕСКОМ РЕЖИМЕ ПОДДЕРЖИВАЕТ ВСЕ РАЗРЯДНОСТИ ПРИЛОЖЕНИЙ (32|64), КОТОРЫЕ ЗАПУЩЕНЫ В СЕСИИ. PYTHON x64 ИМЕЕТ ВОЗМОЖНОСТЬ ВЗЗАИМОДЕЙСТВИЯ С x32 UIO ОБЪЕКТАМИ, НО МЫ РЕКОМЕНДУЕМ ДОПОЛНИТЕЛЬНО ИСПОЛЬЗОВАТЬ ИНТЕРПРЕТАТОР PYTHON x32 (ПОДРОБНЕЕ СМ. ФУНКЦИЮ Configure())</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<spanclass="n">lDemoBaseUIOExistList</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelectorsSecs_WaitAppear_List</span><spanclass="p">([</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">,</span><spanclass="n">lNotepadOKSelector</span><spanclass="p">,</span><spanclass="n">lNotepadCancelSelector</span><spanclass="p">])</span><spanclass="c1"># Ожидать появление UIO объекта</span>
<li><p><strong>inWaitSecs</strong> (<em>float</em><em>, </em><em>необязательный</em>) – Количество секунд, которые отвести на ожидание UIO объектов. По умолчанию 24 часа (86400 секунд)</p></li>
<li><p><strong>inFlagWaitAllInMoment</strong>– True - Ожидать до того момента, пока не появятся все запрашиваемые UIO объекты на рабочей области</p></li>
<ddclass="field-even"><p>Список индексов, которые указывают на номер входящих UIO селекторов, которые были обнаружены на рабочей области. Пример: [0,2]</p>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIOSelectorsSecs_WaitDisappear_List</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inSpecificationListList</span></em>, <emclass="sig-param"><spanclass="n">inWaitSecs</span><spanclass="o">=</span><spanclass="default_value">86400.0</span></em>, <emclass="sig-param"><spanclass="n">inFlagWaitAllInMoment</span><spanclass="o">=</span><spanclass="default_value">False</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIOSelectorsSecs_WaitDisappear_List"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIOSelectorsSecs_WaitDisappear_List"title="Ссылка на это определение">¶</a></dt>
<dd><p>Ожидать исчезновение хотя бы 1-го / всех UIO объектов по заданным UIO селекторам</p>
<p>!ВНИМАНИЕ! ДАННАЯ ФУНКЦИОНАЛЬНОСТЬ В АВТОМАТИЧЕСКОМ РЕЖИМЕ ПОДДЕРЖИВАЕТ ВСЕ РАЗРЯДНОСТИ ПРИЛОЖЕНИЙ (32|64), КОТОРЫЕ ЗАПУЩЕНЫ В СЕСИИ. PYTHON x64 ИМЕЕТ ВОЗМОЖНОСТЬ ВЗЗАИМОДЕЙСТВИЯ С x32 UIO ОБЪЕКТАМИ, НО МЫ РЕКОМЕНДУЕМ ДОПОЛНИТЕЛЬНО ИСПОЛЬЗОВАТЬ ИНТЕРПРЕТАТОР PYTHON x32 (ПОДРОБНЕЕ СМ. ФУНКЦИЮ Configure())</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<li><p><strong>inWaitSecs</strong> (<em>float</em><em>, </em><em>необязательный</em>) – Количество секунд, которые отвести на ожидание исчезновения UIO объектов. По умолчанию 24 часа (86400 секунд)</p></li>
<li><p><strong>inFlagWaitAllInMoment</strong>– True - Ожидать до того момента, пока не исчезнут все запрашиваемые UIO объекты на рабочей области</p></li>
<ddclass="field-even"><p>Список индексов, которые указывают на номер входящих UIO селекторов, которые были обнаружены на рабочей области. Пример: [0,2]</p>
<spanclass="n">lUIO</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_Get_UIO</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1"># Получить UIO объект с помощью UIO селектора</span>
<spanclass="n">lUIOHierarchyList</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOXY_SearchChild_ListDict</span><spanclass="p">(</span><spanclass="n">lUIO</span><spanclass="p">,</span><spanclass="mi">100</span><spanclass="p">,</span><spanclass="mi">200</span><spanclass="p">)</span><spanclass="c1"># Получить UIO объект с помощью UIO селектора родительского элемента и координат X / Y</span>
</pre></div>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Параметры</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>inRootElement</strong> (<em>object UIO</em><em>, </em><em>обязательный</em>) – родительский UIO объект, полученный ранее с помощью UIO селектора.</p></li>
<li><p><strong>inX</strong> (<em>int</em><em>, </em><em>обязательный</em>) – родительский UIO объект, полученный ранее с помощью UIO селектора.</p></li>
<li><p><strong>inY</strong> (<em>int</em><em>, </em><em>обязательный</em>) – родительский UIO объект, полученный ранее с помощью UIO селектора.</p></li>
<spanclass="n">lUIO</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_Get_UIO</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1"># Получить UIO объект по UIO селектору</span>
<spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIO_FocusHighlight</span><spanclass="p">(</span><spanclass="n">lUIO</span><spanclass="p">)</span><spanclass="c1"># Установить фокус и подсветить UIO объект по UIO селектору зеленым цветом с толщиной подсветки 2 px.</span>
</pre></div>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Параметры</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>lWrapperObject</strong> (<em>object UIO</em><em>, </em><em>обязательный</em>) – UIO объект, который будет подсвечен</p></li>
<li><p><strong>colour</strong> (<em>str</em><em>, </em><em>необязательный</em>) – цвет подсветки UIO объекта. Варианты: „red“, „green“, „blue“. По умолчанию „green“</p></li>
<codeclass="sig-prename descclassname">pyOpenRPA.Robot.UIDesktop.</code><codeclass="sig-name descname">UIO_GetCtrlIndex_Int</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inElement</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/pyOpenRPA/Robot/UIDesktop.html#UIO_GetCtrlIndex_Int"><spanclass="viewcode-link">[исходный код]</span></a><aclass="headerlink"href="#pyOpenRPA.Robot.UIDesktop.UIO_GetCtrlIndex_Int"title="Ссылка на это определение">¶</a></dt>
<dd><p>Получить индекс UIO объекта inElement в списке родительского UIO объекта.</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1"># UIDesktop: Взаимодействие с UI объектами приложений</span>
<spanclass="n">lUIO</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_Get_UIO</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1"># Получить UIO объект по UIO селектору.</span>
<spanclass="n">lUIOIndexInt</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIO_GetCtrlIndex_Int</span><spanclass="p">(</span><spanclass="n">lUIO</span><spanclass="p">)</span><spanclass="c1"># Получить индекс UIO объекта в списке у родительского UIO объекта.</span>
</pre></div>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Параметры</dt>
<ddclass="field-odd"><p><strong>inElement</strong> (<em>list</em><em>, </em><em>обязательный</em>) – UIO объект, для которого требуется определить индекс в списке родительского UIO объекта.</p>
</dd>
<dtclass="field-even">Результат</dt>
<ddclass="field-even"><p>int, индекс UIO объекта в списке родительского UIO объекта</p>
<spanclass="n">lUIO</span><spanclass="o">=</span><spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIOSelector_Get_UIO</span><spanclass="p">(</span><spanclass="n">lDemoBaseUIOSelector</span><spanclass="p">)</span><spanclass="c1"># Получить UIO объект по UIO селектору</span>
<spanclass="n">UIDesktop</span><spanclass="o">.</span><spanclass="n">UIO_Highlight</span><spanclass="p">(</span><spanclass="n">lUIO</span><spanclass="p">)</span><spanclass="c1"># Подсветить UIO объект по UIO селектору зеленым цветом с толщиной подсветки 2 px.</span>
</pre></div>
</div>
<dlclass="field-list simple">
<dtclass="field-odd">Параметры</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>lWrapperObject</strong> (<em>object UIO</em><em>, </em><em>обязательный</em>) – UIO объект, который будет подсвечен</p></li>
<li><p><strong>colour</strong> (<em>str</em><em>, </em><em>необязательный</em>) – цвет подсветки UIO объекта. Варианты: „red“, „green“, „blue“. По умолчанию „green“</p></li>
<li><p><strong>inFlagSetFocus</strong> (<em>bool</em><em>, </em><em>необязательный</em>) – признак установки фокуса на UIO объект перед подсветкой. По умолчанию False</p></li>
<h2>Селектор UIO<aclass="headerlink"href="#uio"title="Ссылка на этот заголовок">¶</a></h2>
<p>Селектор UIO - адрес одного и/или более UIO объектов. Селектор представлен в формате списка (list) словарей (dict) атрибутивных критериев. Поддерживает формат JSON, что позволяет обеспечить удобство форматирования и передачи через web интерфейс студии / оркестратора.</p>
<p>UIO селектор — это список характеристических словарей (спецификаций UIO). Данные спецификации UIO содержат условия, с помощью которых библиотека pyOpenRPA определит UIO, удовлетворяющий условиям, заданным в спецификации UIO. Индекс спецификации UIO в списке UIO селектора харакетризует уровень вложенности целевого UIO. Говоря другим языком, UIO селектор — это перечень условий, под которые может попасть 0, 1 или n UIO.</p>
<p>Ниже приведен перечень атрибутов — условий, которые можно использовать в спецификациях UIO:</p>
<p><strong>Формат селектора:</strong></p>
<dl>
<dt>[</dt><dd><p>{</p>
<blockquote>
<div><p>«depth_start» :: [int, начинается с 1] :: глубина, с которой начинается поиск (по умолчанию 1),</p>
<p>«depth_end» :: [int, начинается с 1] :: глубина, до которой ведется поиск (по умолчанию 1),</p>
<p>«ctrl_index» || «index» :: [int, начинается с 0] :: индекс UIO в списке у родительского UIO,</p>
<p>«title» :: [str] :: идентичное наименование атрибута <em>title</em> искомого объекта UIO,</p>
<p>«title_re» :: [str] :: регулярное выражение (python диалект) для отбора UIO, у которого атрибут <em>title</em> должен удовлетворять условию данного регулярного выражения,</p>
<p>«rich_text» :: [str] :: идентичное наименование атрибута <em>rich_text</em> искомого объекта UIO,</p>
<p>«rich_text_re» :: [str] :: регулярное выражение (python диалект) для отбора UIO, у которого атрибут <em>rich_text</em> должен удовлетворять условию данного регулярного выражения,</p>
<p>«class_name» :: [str] :: идентичное наименование атрибута <em>class_name</em> искомого объекта UIO,</p>
<p>«class_name_re» :: [str] :: регулярное выражение (python диалект) для отбора UIO, у которого атрибут <em>class_name</em> должен удовлетворять условию данного регулярного выражения,</p>
<p>«friendly_class_name» :: [str] :: идентичное наименование атрибута <em>friendly_class_name</em> искомого объекта UIO,</p>
<p>«friendly_class_name_re» :: [str] :: регулярное выражение (python диалект) для отбора UIO, у которого атрибут <em>friendly_class_name</em> должен удовлетворять условию данного регулярного выражения,</p>
<p>«control_type» :: [str] :: идентичное наименование атрибута <em>control_type</em> искомого объекта UIO,</p>
<p>«control_type_re» :: [str] :: регулярное выражение (python диалект) для отбора UIO, у которого атрибут <em>control_type</em> должен удовлетворять условию данного регулярного выражения,</p>
<p>«is_enabled» :: [bool] :: признак, что UIO доступен для выполнения действий,</p>
<p>«is_visible» :: [bool] :: признак, что UIO отображается на экране,</p>
<p>«backend» :: [str, «win32» || «uia»] :: вид способа адресации к UIO (по умолчанию «win32»). Внимание! Данный атрибут может быть указан только для первого элемента списка UIO селектора. Для остальных элементов списка данный атрибут будет проигнорирован.</p>
</div></blockquote>
<p>},
{ … спецификация UIO следующего уровня иерархии }</p>
<div><p>{«class_name»:»CalcFrame», «backend»:»win32»}, # Спецификация UIO 1-го уровня вложенности
{«title»:»Hex», «depth_start»:3, «depth_end»: 3} # Спецификация UIO 1+3-го уровня вложенности (так как установлены атрибуты depth_start|depth_stop, определяющие глубину поиска UIO)</p>
</div></blockquote>
<p>]</p>
<p><strong>UIO объект - свойства и методы (общие)</strong></p>
<ulclass="simple">
<li><p>process_id(): Возвращает идентификатор процесса, которому принадлежит это окно</p></li>
<li><p>window_text(): Текст окна элемента. Довольно много элементов управления имеют другой текст, который виден, например, элементы управления редактированием обычно имеют пустую строку для window_text, но все равно имеют текст, отображаемый в окне редактирования.</p></li>
<li><p>rectangle(): Возвращает прямоугольник элемента: {«сверху», «слева», «справа», «снизу»} Прямоугольник() - это прямоугольник элемента на экране. Координаты указаны в левом верхнем углу экрана. Этот метод возвращает прямоугольную структуру, которая имеет атрибуты - top, left, right, bottom. и имеет методы width() и height(). См. раздел win32structures.Прямую кишку для получения дополнительной информации.</p></li>
<li><p>right_click_input(coords=(None, None)): Щелкните правой кнопкой мыши на указанных координатах</p></li>
<li><p>click_input(button=“left“, coords=(None, None), button_down=True, button_up=True, double=False, wheel_dist=0, use_log=True, pressed=““, absolute=False, key_down=True, key_up=True): Щелкните по указанным координатам кнопкой мыши, чтобы щелкнуть. Один из «влево», «вправо», «посередине» или «x» (по умолчанию: «влево», «переместить» - это особый случай) определяет координаты, по которым нужно щелкнуть.(По умолчанию: центр элемента управления) дважды Укажите, следует ли выполнять двойной щелчок или нет (по умолчанию: False) wheel_dist Расстояние для перемещения колеса мыши (по умолчанию: 0) Внимание: Этот метод отличается от метода щелчка тем, что он требует, чтобы элемент управления был виден на экране, но выполняет более реалистичную симуляцию щелчка. Этот метод также уязвим, если пользователь перемещает мышь, поскольку это может легко переместить мышь с элемента управления до завершения click_input.</p></li>
<li><p>double_click_input(button=“left“, coords=(None, None)): Дважды щелкните по указанным координатам</p></li>
<li><p>press_mouse_input(button=“left“, coords=(None, None), pressed=““, absolute=True, key_down=True, key_up=True): Нажмите кнопку мыши с помощью SendInput</p></li>
<li><p>drag_mouse_input(dst=(0, 0), src=None, button=“left“, pressed=““, absolute=True): Нажмите на src, перетащите его и перетащите на dst dst - это объект-оболочка назначения или просто координаты. src - это исходный объект-оболочка или координаты. Если src равен None, self используется в качестве исходного объекта. кнопка - это кнопка мыши, которую нужно удерживать во время перетаскивания. Это может быть “влево”, “вправо”, “посередине” или “x”. Нажата клавиша на клавиатуре, которую нужно нажимать во время перетаскивания. абсолютные указывает, следует ли использовать абсолютные координаты для расположения указателя мыши</p></li>
<li><p>draw_outline(colour=“green“, thickness=2, fill=<MagicMock name=“mock.win32defines.BS_NULL“ id=“140124673757368“>, rect=None): Нарисуйте контур вокруг окна. цвет может быть либо целым числом, либо одним из «красного», «зеленого», «синего» (по умолчанию «зеленый») толщина толщина прямоугольника (по умолчанию 2) заливка как заполнить прямоугольник (по умолчанию BS_NULL) укажите координаты прямоугольника для рисования (по умолчанию используется прямоугольник элемента управления)</p></li>
<li><p>element_info: Свойство, доступное только для чтения, для получения объекта ElementInfo</p></li>
<li><p>from_point(x, y): Получить объект-оболочку для элемента в заданных координатах экрана (x, y)</p></li>
<li><p>get_properties(): Возвращает свойства элемента управления в виде словаря.</p></li>
<li><p>is_child(parent): Возвращает значение True, если этот элемент является дочерним элементом ‘parent’. Элемент является дочерним элементом другого элемента, когда он является прямым элементом другого элемента. Элемент является прямым потомком данного элемента, если родительский элемент является цепочкой родительских элементов для дочернего элемента.</p></li>
<li><p>is_dialog(): Возвращает значение True, если элемент управления является окном верхнего уровня</p></li>
<li><p>is_enabled(): Независимо от того, включен элемент или нет. Проверяет, что как родительский элемент верхнего уровня (возможно, диалоговое окно), которому принадлежит этот элемент, так и сам элемент включены.Если вы хотите дождаться, пока элемент станет включенным (или дождаться, пока он станет отключенным), используйте Application.wait(„visible“) или Application.wait_not(„visible“).Если вы хотите немедленно вызвать исключение, если элемент не включен, вы можете использовать BaseWrapper.verify_enabled(). Функция BaseWrapper.Verify Ready() вызывается, если окно одновременно не видно и не включено.</p></li>
<li><p>is_visible(): Является ли элемент видимым или нет. Проверяет, видны ли как родительский элемент верхнего уровня (возможно, диалоговое окно), которому принадлежит этот элемент, так и сам элемент. Если вы хотите дождаться, пока элемент станет видимым (или дождаться, пока он станет скрытым), используйте Application.wait(„visible“) или Application.wait_not(„visible“). Если вы хотите немедленно вызвать исключение, если элемент не виден, вы можете использовать BaseWrapper.verify_visible(). Базовая оболочка.verify_actible() вызывается, если элемент одновременно не виден и не включен.</p></li>
<li><p>parent(): Возвращает родительский элемент этого элемента Обратите внимание, что родительским элементом элемента управления не обязательно является диалоговое окно или другое главное окно. Например, поле группы может быть родительским для некоторых переключателей. Чтобы получить главное (или окно верхнего уровня), затем используйте BaseWrapper.top_level_parent().</p></li>
<li><p>root(): Возвращаемая оболочка для корневого элемента (рабочий стол)</p></li>
<li><p>set_focus(): Установить фокус на этот элемент</p></li>
<li><p>texts(): Возвращает текст для каждого элемента этого элемента управления Это список строк для элемента управления. Часто переопределяется извлечение всех строк из элемента управления с несколькими элементами. Это всегда список с одной или несколькими строками: Первый элемент - это текст окна элемента управления Последующие элементы содержат текст любых элементов элемента управления (например, элементы в listbox/combobox, вкладки в tabcontrol)</p></li>
<li><p>type_keys(keys, pause=None, with_spaces=False, with_tabs=False, with_newlines=False, turn_off_numlock=True, set_foreground=True, vk_packet=True): Введите ключи для элемента с помощью клавиатуры.send_keys. Ограниченная функциональность. Для более полной функциональности рекомендуем ознакомится с pyOpenPRA.Robot.Keyboard</p></li>
<li><p>was_maximized(): Проверить, было ли окно развернуто перед сворачиванием или нет</p></li>
</ul>
<p><strong>UIO свойства и методы (дополнение к базовым методам для win32 элементов)</strong></p>
<li><p>get_check_state(): Вернуть состояние проверки флажка. Состояние проверки представлено целым числом 0 - непроверено 1 - проверено 2 - неопределенно. Следующие константы определены в модуле win32defines BST_UNCHECKED = 0 BST_CHECKED = 1 BST_INDETERMINATE = 2</p></li>
<li><p>click(button=“left“, pressed=““, coords=(0, 0), double=False, absolute=False): Клик на кнопку управления</p></li>
<li><p>is_checked(): Возвращает True, если флажок установлен, False, если флажок не установлен, None, если значение не определено</p></li>
<li><p>is_dialog(): Кнопки никогда не являются диалоговыми окнами, поэтому возвращайте значение False</p></li>
<li><p>set_check_indeterminate(): Установить флажок в положение неопределенный</p></li>
<li><p>friendly_class_name(): Возвращает имя класса кнопки. Они могут выглядеть следующим образом: Кнопки, этот метод возвращает “Button”; Флажки, этот метод возвращает “флажок”; RadioButtons, этот метод возвращает “RadioButton”; GroupBoxes, этот метод возвращает “GroupBox”</p></li>
</ul>
<p><strong>Поле выбора нескольких значений из списка (ComboBox)</strong></p>
<li><p>dropped_rect(): Получить выпадающий прямоугольник в поле со списком</p></li>
<li><p>get_properties(): Возвращает свойства элемента управления в виде словаря</p></li>
<li><p>item_count(): Возвращает количество элементов в поле со списком</p></li>
<li><p>item_data(item): Возвращает данные элемента, связанные с элементом, если таковые имеются</p></li>
<li><p>item_texts(): Возвращает текст элементов выпадающего списка</p></li>
<li><p>select(item): Выбрать элемент со списком элемент может быть либо индексом элемента для выбора на основе 0, либо строкой, которую вы хотите выбрать</p></li>
<li><p>line_count(): Возвращает, сколько строк есть в редактировании</p></li>
<li><p>line_length(line_index): Возвращает количество символов в строке</p></li>
<li><p>select(start=0, end=None): Установите выбор редактирования элемента управления редактированием</p></li>
<li><p>selection_indices(): Начальный и конечный индексы текущего выбора</p></li>
<li><p>set_edit_text(text, pos_start=None, pos_end=None): Задать текст элемента управления редактированием</p></li>
<li><p>set_text(text, pos_start=None, pos_end=None): Задать текст элемента управления редактированием</p></li>
<li><p>set_window_text(text, append=False): Переопределите set_window_text для элементов управления редактированием, поскольку он не должен использоваться для элементов управления редактированием. Элементы управления редактированием должны использовать либо set_edit_text(), либо type_keys() для изменения содержимого элемента управления редактированием.</p></li>
<li><p>text_block(): Получить текст элемента управления редактированием</p></li>
<li><p>texts(): Получить текст элемента управления редактированием</p></li>
</ul>
<p><strong>Поле выбора 1-го значения из списка (ListBox)</strong></p>
<li><p>get_item_focus(): Возвращает индекс текущего выбора в списке</p></li>
<li><p>is_single_selection(): Проверить, имеет ли поле списка режим одиночного выбора</p></li>
<li><p>item_count(): Возвращает количество элементов в списке</p></li>
<li><p>item_data(i): Возвращает item_data, если таковые имеются, связанные с элементом</p></li>
<li><p>item_texts(): Возвращает текст элементов списка</p></li>
<li><p>select(item, select=True): Выбрать элемент списка элемент может быть либо индексом элемента для выбора на основе 0, либо строкой, которую вы хотите выбрать</p></li>
<li><p>selected_indices(): Выбранные в данный момент индексы списка</p></li>
<li><p>set_item_focus(item): Установить фокус по элементу</p></li>
<li><p>texts(): Получить текст элемента управления редактированием</p></li>
<p><strong>Инициализация 2-х разрядностей для UIO</strong></p>
<p>pyOpenRPA позволяет обеспечить максимальную совместимость со всеми приложениями, которые выполняются на компьютере. Мы рекомендуем разрабатывать робота под интерпретатором Python x64. В дополнение к нему Вы можете подключить Python x32 (см. ниже пример подключения). Если планируемый робот не будет взаимодействовать через pyOpenRPA.Robot.UIDesktop с другой разрядность, то эту настройку можно не применять.</p>
<spanclass="c1"># В нашем случае процесс робота будет исполняться на Python x64. Дополнительно подключим Python x32 (делать это только, если вы планируете работать в другой разрядностью в рамках робота)</span>
<spanclass="s2">"Python32FullPath"</span><spanclass="p">:</span><spanclass="s2">"..</span><spanclass="se">\\</span><spanclass="s2">Resources</span><spanclass="se">\\</span><spanclass="s2">WPy32-3720</span><spanclass="se">\\</span><spanclass="s2">python-3.7.2</span><spanclass="se">\\</span><spanclass="s2">python.exe"</span><spanclass="p">,</span><spanclass="c1"># Путь к интерпретатору Python.exe x32</span>
<spanclass="s2">"Python64FullPath"</span><spanclass="p">:</span><spanclass="s2">"..</span><spanclass="se">\\</span><spanclass="s2">Resources</span><spanclass="se">\\</span><spanclass="s2">WPy64-3720</span><spanclass="se">\\</span><spanclass="s2">python-3.7.2.amd64</span><spanclass="se">\\</span><spanclass="s2">python.exe"</span><spanclass="p">,</span><spanclass="c1"># Путь к интерпретатору Python.exe x64</span>
<spanclass="s2">"Python32ProcessName"</span><spanclass="p">:</span><spanclass="s2">"pyOpenRPA_UIDesktopX32.exe"</span><spanclass="p">,</span><spanclass="c1"># Наименование процесса робота x32 в диспетчере задач. Установите свое наименование</span>
<spanclass="s2">"Python64ProcessName"</span><spanclass="p">:</span><spanclass="s2">"pyOpenRPA_UIDesktopX64.exe"</span><spanclass="c1"># Наименование процесса робота x64 в диспетчере задач. Установите свое наименование</span>
<spanclass="p">}</span>
<spanclass="c1"># Инициализировать 2-й разрядность.</span>
<spanclass="c1"># Теперь при вызове функций pyOpenRPA.Robot.UIDesktop платформа pyOpenRPA будет отслеживать разрядность приложения и отправлять соответсвующий вызов на идентичную разрядность.</span>
</pre></div>
</div>
</div>
<divclass="section"id="id3">
<h2>Быстрая навигация<aclass="headerlink"href="#id3"title="Ссылка на этот заголовок">¶</a></h2>
