.. _gsauto_ug_application:

Объект приложения
=================

Объект приложения (:java:type:`Application <ru.bitec.gs.automation.client.ui.Application>`)
предоставляет доступ к интерфейсу приложения.

Библиотека создаёт этот объект после успешного подключения к серверу приложений
и аутентификации в приложении.

При использовании окружений выполнения ``gs-automation-environments``, объект приложения присваивается предопределенной 
переменной ``application``.

.. seealso::
   - API: :java:type:`ru.bitec.gs.automation.client.ui.Application <ru.bitec.gs.automation.client.ui.Application>`
   - Руководство пользователя: :ref:`gsauto_ug_app`
   - Руководство пользователя: :ref:`gsauto_ug_junit`
   - Руководство пользователя: :ref:`gsauto_ug_artifacts`


Объект приложения предоставляет доступ к :java:type:`главной форме <ru.bitec.gs.automation.client.ui.MainForm>`
и :java:type:`вкладкам открытых MDI-форм <ru.bitec.gs.automation.client.ui.layout.tab.MdiPanel>` приложения.

Объект главной формы предоставляет доступ к :java:type:`главному меню <ru.bitec.gs.automation.client.ui.menu.MainMenu>` и
:java:type:`главной выборке <ru.bitec.gs.automation.client.ui.Selection>`.


.. code-block:: java
   :caption: Получение объектов интерфейса. 

   MdiPanel mdiPanel = application.mdipanel();
   MainForm mainForm = application.mainForm();
   MainMenu mainMenu = mainForm.mainMenu();
   Selection mainSelection = mainForm.mainSelection();

.. seealso::
   - Руководство пользователя: :ref:`gsauto_ug_menu`
   - Руководство пользователя: :ref:`gsauto_ug_forms`
   - Руководство пользователя: :ref:`gsauto_ug_selection`
   - API: :java:type:`ru.bitec.gs.automation.client.ui.layout.tab.MdiPanel <ru.bitec.gs.automation.client.ui.layout.tab.MdiPanel>`
   - API: :doc:`Справочник API библиотеки <../../javadoc/packages>`