.. _spec_ui-components_form:

Форма
=========
Корневой элемент графического интерфейса размещающий в себе :term:`компоновщик` и :term:`фреймы<фрейм>`.

Форма может быть открыта 4-х режимах:

- Main - главная форма.
- Modal - модальная форма.
- Lookup - форма выбора.
- MDI - закладка в рабочей области главной формы.

Main
---------------
Главная форма является корневым элементом пользовательского графического интерфейса.
У приложения может быть только одна главная форма.
Содержимое главной формы определяется метаданным главной выборки приложения.

- Для PostgreSQL решения: главная форма может отображать произвольную компоновку :ref:`фреймов<фрейм>`.
  По умолчанию, фрейм рабочего стола ``CoreDesktop``.
- Для Oracle решения: главная форма всегда отображает фрейм рабочего стола ``CoreDesktop``.

.. seealso::
   :java:type:`ru.bitec.gtk.core.gl.frame.CoreDesktop`

Modal
-----------------
Модальная форма отображается поверх всех, открытых ранее форм, блокируя доступ к ним. Открытие модальной формы
запускает вложенный цикл обработки команд клиентского приложения, в ожидании команды закрытия формы. До закрытия
формы, команда, приведшая к открытию формы, считается не завершённой, и java-стек не раскручивается. Результатом
закрытия формы является значение: успех/отмена.

.. seealso::
   :java:meth:`ru.bitec.gtk.core.gl.CoreFormManagerItem.openModal()`

Lookup
-----------------
Форма выбора открывается аналогично модальной форме. В отличие от модальной формы, результатом закрытия формы выбора
является структура, возвращающая данные, запрошенные из :term:`выборок<выборка>` формы.

.. seealso::
   :java:meth:`ru.bitec.gtk.core.gl.CoreFormManagerItem.openLookup()`,
   :java:type:`ru.bitec.gtk.core.gl.CoreLookupData`

MDI
-----------------
:term:`MDI` формы отображаются в виде закладок в рабочей области главной формы. Формы не блокируют интерфейс. Между
MDI формами возможно переключаться. Из MDI формы не возможно вернуть значения.

.. seealso::
   :java:meth:`ru.bitec.gtk.core.gl.CoreFormManagerItem.open()`