.. _module.studio.how-to-use:

####################################
2. Как использовать?
####################################

.. _general:

************************
Общее
************************

-  `Как запустить? <#how-to-run>`__
-  `Описание UI студии <#ui-description>`__
-  `Извлечь UI дерево <#how-to-extract-ui-tree>`__
-  `Поиск UI объекта по наведению мыши <#how-to-search-ui-object-by-mouse-hover>`__
-  `Извлечь свойства UI объекта <#how-to-extract-ui-object-properties>`__

.. _how-to-run:

************************
Как запустить?
************************

-  Запустить файл Studio\start.cmd
-  Ожидать текст в окне консоли: "running server". Браузер, установленный по умолчанию откроется автоматически
-  **!ВНИМАНИЕ!** Студия поддерживает все версии браузеров, кроме Internet Explorer.

.. image:: /img/504b98f76747f63900a2943532a946bb.png
   :alt: 504b98f76747f63900a2943532a946bb.png

.. _ui-description:

************************
Описание UI студии
************************

**Интерфейс (UI) студии состоит из следующих компонентов:**

1. Обозреватель UI дерева
2. Обозреватель иерархии выбранного UI объекта
3. Обозреватель свойств выбранного уровня UI объекта
4. Редактор UIO селектора
5. Панель активностей над UIO объектом
6. Панель других Python активностей
7. Список активностей

*Ниже представлены скриншоты студии*

Скриншот 1
----------------

.. image:: /img/d3d6ad14a7e50843bd89d2b14a092fee.png
   :alt: 504b98f76747f63900a2943532a946bb.png


Скриншот 2
----------------

.. image:: /img/65b7d51c0a5b21e6b27dc23d4062d3ca.png
   :alt: 65b7d51c0a5b21e6b27dc23d4062d3ca.png


.. _how-to-extract-ui-tree:

************************
Извлечь UI дерево
************************

Чтобы извлечь дерево пользовательского интерфейса выполните следующие действия: в ``UI Tree viewer`` выбрать интересующий UI объект и нажать кнопку ``Expand``.

Действие: Нажать по кнопке "Expand"
---------------------------------------

.. image:: /img/6effc376ff6ea928840674bd744caced.png
   :alt: 6effc376ff6ea928840674bd744caced.png

Итог
---------------------------------------

.. image:: /img/18b9ab36126c8c32168bf5bbb9330701.png
   :alt: 18b9ab36126c8c32168bf5bbb9330701.png


---------------------------------------

.. _how-to-search-ui-object-by-mouse-hover:

***********************************
Поиск UI объекта по наведению мыши
***********************************

Чтобы выполнить поиск UI объекта пользовательского интерфейса, необходимо в ``UI tree viewer`` выбрать родительский UI объект, в котором вы хотите выполнить поиск, и нажать кнопку ``Mouse search``.

Будет активирован режим поиск UI объекта по курсору мыши. Наведите курсор мыши на интересующий вас объект пользовательского интерфейса и дождитесь, когда студия выделит объект пользовательского интерфейса. После выделения цветов удерживайте клавишу "Ctrl" и подождите 3 секунды. Интересующий UI объект будет показан в ``UI tree viewer``.

Действие: Нажать кнопку "Mouse search"
---------------------------------------

.. image:: /img/84d7e4de0c840631f87cf7b325b53ad8.png
   :alt: 84d7e4de0c840631f87cf7b325b53ad8.png

Действие: Навести курсор мыши на UI объект, который интересует и зажать клавишу "Ctrl" на 3 секунды
--------------------------------------------------------------------------------------------------------------

.. image:: /img/b7c38d622bf5b7afa5b26d1686d7302a.png
   :alt: b7c38d622bf5b7afa5b26d1686d7302a.png

Итог: Интересующий UI объект будет отображен в ``UI tree viewer``
--------------------------------------------------------------------

.. image:: /img/629bbf4db2c01b9c640194230949fcd2.png
   :alt: 629bbf4db2c01b9c640194230949fcd2.png

.. _how-to-extract-ui-object-properties:

***********************************
Извлечь свойства UI объекта
***********************************

Чтобы извлечь свойства UI объекта, необходимо в
``Selected UI object hierarchy list`` выбрать интересующий UI объект и щелкнуть по нему. Список свойств UI объекта будет отображен в ``Selected UI object property list``

Действие: Choose the UI object you are interested and click it
------------------------------------------------------------------------------

.. image:: /img/2c27be5bdde20b5d062cbb40e74eaec5.png
   :alt: 2c27be5bdde20b5d062cbb40e74eaec5.png

Итог: Свойства UI объекта будут отображены в ``Selected UI object property list``
-----------------------------------------------------------------------------------------

.. image:: /img/f235ae29099a713e0246cd574ac3a17c.png
   :alt: f235ae29099a713e0246cd574ac3a17c.png


******************************
Быстрая навигация
******************************

- `Сообщество pyOpenRPA (telegram) <https://t.me/pyOpenRPA>`_
- `Сообщество pyOpenRPA (tenchat) <https://tenchat.ru/iMaslov?utm_source=19f2a84f-3268-437f-950c-d987ae42af24>`_
- `Сообщество pyOpenRPA (вконтакте) <https://vk.com/pyopenrpa>`_
- `Презентация pyOpenRPA <https://pyopenrpa.ru/Index/pyOpenRPA_product_service.pdf>`_
- `Портал pyOpenRPA <https://pyopenrpa.ru>`_
- `Репозиторий pyOpenRPA <https://gitlab.com/UnicodeLabs/OpenRPA>`_