.. _gsauto_ug_forms:

Объект формы
============

Библиотека предлагает два основных способа доступа к объектам форм:

1. Получение отображенной на интерфейсе формы.
2. Ожидание отображения формы на интерфейсе.

Чаще всего целесообразно использовать второй способ — ожидание, так как форме 
требуется некоторое время для загрузки.



Пример ожидания появления формы:

.. code-block:: java
   :caption: Ожидание появления формы

   Form form = application.waitMdiForm("gtk-ru.bitec.app.gs3.qa.form.open_card_type.Gs3_QAReferenceMdiCard", "List");

.. seealso::
   - Спецификация: :ref:`gsauto_namingconventions`
   - Руководство пользователя: :ref:`gsauto_ug_application`

Библиотекой поддерживаются следующие виды открытия форм:

   - :java:type:`Главная форма приложения <ru.bitec.gs.automation.client.ui.AbstractForm.OpenType.MAIN_FORM>`
   - :java:type:`MID-форма <ru.bitec.gs.automation.client.ui.AbstractForm.OpenType.MDI>`
   - :java:type:`Модальная форма <ru.bitec.gs.automation.client.ui.AbstractForm.OpenType.MODAL>`
   - :java:type:`Lookup-форма <ru.bitec.gs.automation.client.ui.AbstractForm.OpenType.LOOKUP>`



.. seealso::
   - API: :java:type:`ru.bitec.gs.automation.client.ui.AbstractForm.OpenType <ru.bitec.gs.automation.client.ui.AbstractForm.OpenType>` 
   - API: :java:type:`ru.bitec.gs.automation.client.ui.Form <ru.bitec.gs.automation.client.ui.Form>`

Переключение между MDI-формами
------------------------------

Переключение между открытыми MDI-формами выполняется вызовом
метода :java:meth:`click() <ru.bitec.gs.automation.client.Clickable.click()>` на вкладках панели MDI-форм.

.. code-block:: java
   :caption: Переключение между MDI-формами

   MdiPanel mdiPanel = application.mdipanel();
   mdiPanel.itemByCaption("Справочник с модальной карточкой").click();
   mdiPanel.itemByName("gtk-ru.bitec.app.gs3.qa.gsauto.Gs3_QaGsAuto_Units_Editors_Card#Card").click();

.. seealso::
   - API: :java:type:`ru.bitec.gs.automation.client.ui.layout.tab.MdiPanel <ru.bitec.gs.automation.client.ui.layout.tab.MdiPanel>`
   - API: :java:type:`ru.bitec.gs.automation.client.Clickable <ru.bitec.gs.automation.client.Clickable>`
   - Руководство пользователя: :ref:`gsauto_ug_application`
   - Руководство пользователя: :ref:`gsauto_ug_clickable`