.. _gsauto_ug_fields:

Объект поля ввода
=================

Полем ввода считается элемент интерфейса, связанный с редактором
атрибута записи выборки. 

Библиотека предоставляет набор классов полей ввода для взаимодействия со
стандартными типами редакторов:

1. :java:type:`ButtonBox<ru.bitec.gs.automation.client.ui.layout.editor.field.ButtonBox>`
2. :java:type:`ButtonsEditBox<ru.bitec.gs.automation.client.ui.layout.editor.field.ButtonsEditBox>`
3. :java:type:`CalendarBox<ru.bitec.gs.automation.client.ui.layout.editor.field.CalendarBox>`
4. :java:type:`CheckBox<ru.bitec.gs.automation.client.ui.layout.editor.field.CheckBox>`
5. :java:type:`ColorPickBox<ru.bitec.gs.automation.client.ui.layout.editor.field.ColorPickBox>`
6. :java:type:`ComboBox<ru.bitec.gs.automation.client.ui.layout.editor.field.ComboBox>`
7. :java:type:`CurrencyBox<ru.bitec.gs.automation.client.ui.layout.editor.field.CurrencyBox>`
8. :java:type:`DateBox<ru.bitec.gs.automation.client.ui.layout.editor.field.DateBox>`
9. :java:type:`DateTimeBox<ru.bitec.gs.automation.client.ui.layout.editor.field.DateTimeBox>`
10. :java:type:`EditButtonBox<ru.bitec.gs.automation.client.ui.layout.editor.field.EditButtonBox>`
11. :java:type:`HotKeyBox<ru.bitec.gs.automation.client.ui.layout.editor.field.HotKeyBox>`
12. :java:type:`HyperLinkBox<ru.bitec.gs.automation.client.ui.layout.editor.field.HyperLinkBox>`
13. :java:type:`ImageCollectionBox<ru.bitec.gs.automation.client.ui.layout.editor.field.ImageCollectionBox>`
14. :java:type:`LookupComboBox<ru.bitec.gs.automation.client.ui.layout.editor.field.LookupComboBox>`
15. :java:type:`MemoBox<ru.bitec.gs.automation.client.ui.layout.editor.field.MemoBox>`
16. :java:type:`TagComboBox<ru.bitec.gs.automation.client.ui.layout.editor.field.TagComboBox>`
17. :java:type:`TextBox<ru.bitec.gs.automation.client.ui.layout.editor.field.TextBox>`
18. :java:type:`TimeBox<ru.bitec.gs.automation.client.ui.layout.editor.field.TimeBox>`

Редакторы
---------

Каждый класс поля ввода реализует интерфейс :java:type:`AbstractEditor<ru.bitec.gs.automation.client.ui.layout.editor.AbstractEditor>`.
В этом интерфейсе объявлены методы получения и установки значения.

.. code-block:: java
   :caption: Чтение и установка значения поля

   Object value = field.value();
   field.setValue("new_value");

Данные методы позволяют программно считывать и устанавливать значения в любом редакторе поля.

.. code-block:: java
   :caption: Получение значения из поля фильтра и установка нового значения

   application.mainForm().mainMenu().item("MM_GSAUTO_UNITCASES", "MM_GSAUTO_UNITCASES_EDITORS_GRID").click();

   Form form = application.waitMdiForm("gtk-ru.bitec.app.gs3.qa.gsauto.Gs3_QaGsAuto_Units_Editors_Card", "List");
   Frame frame = form.mainSelection().layout().frame();
   FilterPanel filters = frame.filters();

   Object oldValue = filters.field("FLT_PMEMOBOX").value();
   filters.field("FLT_PMEMOBOX").setValue("updated " + oldValue);

Редакторы с кнопками
--------------------

При нажатии кнопки в "редакторе с кнопками" обычно отображается выпадающая
панель. 

Каждый редактор с кнопками, нажатие на которые приводит к отображению выпадающей
панели, реализовывает программный интерфейс :java:type:`WithDropDown<ru.bitec.gs.automation.client.ui.layout.editor.field.dropdown.WithDropDown>`.

Интерфейс декларирует метод :java:meth:`waitDropdown()<ru.bitec.gs.automation.client.ui.layout.editor.field.dropdown.WithDropDown.waitDropdown()>`, 
возвращающий объект, представляющий отображенную панель.

Пример использования редактора с кнопками:

.. code-block:: java
   :caption: Открытие выпадающей панели

   application.mainForm().mainMenu().item("MM_GSAUTO_UNITCASES", "MM_GSAUTO_UNITCASES_EDITORS_CARD").click();

   Form form = application.waitMdiForm("gtk-ru.bitec.app.gs3.qa.gsauto.Gs3_QaGsAuto_Units_Editors_Card", "Card");
   Card card = form.mainSelection().layout().frame().view().as(Card.class);

   ComboBox<?> field = card.field("PLOOKUPCOMBOBOXHL");
   List<AbstractButtonsInputBox.InboxButton> buttons = field.buttons();
   AbstractButtonsInputBox.InboxButton button = buttons.get(0);

   button.click();
   GridDropDown dropDown = field.waitDropdown();

В примере продемонстрирован вызов панели со списком.

Библиотека предоставляет классы для стандартных
типов выпадающих панелей:

1. :java:type:`ColorPaletteDropDown<ru.bitec.gs.automation.client.ui.layout.editor.field.dropdown.ColorPaletteDropDown>`
2. :java:type:`ColorSelectDropDown<ru.bitec.gs.automation.client.ui.layout.editor.field.dropdown.ColorSelectDropDown>`
3. :java:type:`DateDropDown<ru.bitec.gs.automation.client.ui.layout.editor.field.dropdown.DateDropDown>`
4. :java:type:`DateTimeDropDown<ru.bitec.gs.automation.client.ui.layout.editor.field.dropdown.DateTimeDropDown>`
5. :java:type:`GridDropDown<ru.bitec.gs.automation.client.ui.layout.editor.field.dropdown.GridDropDown>`
6. :java:type:`HotkeyDropDown<ru.bitec.gs.automation.client.ui.layout.editor.field.dropdown.HotkeyDropDown>`