####################################
2. How to use
####################################

Content
=======

-  `How to run <#how-to-run>`__
-  `UI Description <#ui-description>`__
-  `How to extract UI tree <#how-to-extract-ui-tree>`__
-  `How to search UI object by mouse
   hover <#how-to-search-ui-object-by-mouse-hover>`__
-  `How to extract UI object
   properties <#how-to-extract-ui-object-properties>`__

How to run
==========

-  For OS x32
-  Run (double click): OpenRPA\_32.cmd (for OS x32)
-  For OS x64
-  Run (double click): OpenRPA\_64.cmd (for OS x64)
-  Wait text "running server" in console. Default browser will be open
   automatically
-  **Attention!** The studio tool does not support the Internet explorer
   (any version) for GUI rendering (lol)

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


UI Description
==============

**The studio tool GUI contains of:**

1. UI tree viewer
2. Selected UI object hierarchy list
3. Selected UI object property list
4. UIO selector editor
5. UIO action panel
6. Another Python activity panel
7. Action/activity list

*Look it on the GUI screenshots are listed below*

GUI Screenshot 1
----------------

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


GUI Screenshot 2
----------------

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


How to extract UI tree
======================

In order to extract the UI tree do the following: in ``UI tree viewer``
choose the object you are interested and click the button "Expand". ##

Action: Click the button "Expand"
---------------------------------------

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

Result
---------------------------------------

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

How to search UI object by mouse hover
---------------------------------------
In order to search UI object do the
following: in ``UI tree viewer`` choose the parent object, where you are
want to search UI object, and click the button "Mouse search". The mouse
search mode will start. Turn mouse on the UI object you are interested
and wait when the studio will highlight the UI object. After the
hightlight hold the "Ctrl" key and wait 3 seconds. The interested UI
object will be shown in ``UI tree viewer``.

Action: Click the button "Mouse search"
---------------------------------------

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

Action: Turn mouse on the UI object you are interested and hold the "Ctrl" key for 3 seconds
--------------------------------------------------------------------------------------------

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

Result: The interested UI object will be shown in ``UI tree viewer``
--------------------------------------------------------------------

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

How to extract UI object properties
===================================

In order to extract UI object properties do the following: in
``Selected UI object hierarchy list`` choose the UI object you are
interested and click it. The UI object property list will be shown in
``Selected UI object property list``

Action: Choose the UI object you are interested and click it
------------------------------------------------------------------------------

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

Result: The UI object property list will be shown in ``Selected UI object property list``
-----------------------------------------------------------------------------------------

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