.. _gsauto_ug_keyboardinput:

Ввод с клавиатуры
=================

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

Для имитации ввода с клавиатуры в библиотеке создан интерфейс 
:java:type:`KeyboardInput<ru.bitec.gs.automation.client.KeyboardInput>`. Этот интерфейс
реализован большинством классов, отвечающих за взаимодействие с элементами интерфейса.


.. seealso::
   - Руководство пользователя: :ref:`gsauto_ug_fields`
   - Руководство пользователя: :ref:`gsauto_ug_grid`
   - API: :doc:`Справочник API библиотеки <../../javadoc/packages>`

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

.. code-block:: java
   :caption: Имитация ввода с клавиатуры

   application.mainForm().mainMenu().item("mm_Selection", "random400RowsCount").click();
   Form form = application.waitMdiForm("gtk-ru.bitec.app.gs3.qa.gsauto.Gs3_QaGsAuto_Units_400Lines_Grid", "List");
   Frame frame = form.mainSelection().layout().frame();
   Grid grid = frame.view().cast();

   grid.sendKeys(Keys.ARROW_DOWN);           

   grid.press(Shortcut.Ctrl(Keys.ARROW_DOWN));

   grid.getCell(1, "SMEMO").field().sendKeys(Keys.ENTER + "буквы и цифры" + Keys.ENTER);

   application.press(Keys.ESCAPE);

Пример демонстрирует различные способы ввода клавиатурных последовательностей и комбинаций.

.. note::
   Реальный сценарий использования будет зависеть от 
   особенностей конкретного прикладного интерфейса.


.. seealso::
   - API: :java:type:`ru.bitec.gs.automation.client.KeyboardInput <ru.bitec.gs.automation.client.KeyboardInput>`
   - API: :java:type:`ru.bitec.gs.automation.client.KeyboardInput.Shortcut <ru.bitec.gs.automation.client.KeyboardInput.Shortcut>`