.. java:import:: java.time Duration .. java:import:: java.util Optional .. java:import:: org.openqa.selenium WebElement .. java:import:: ru.bitec.gs.automation.client BrowserContext .. java:import:: ru.bitec.gs.automation.client KeyboardInput .. java:import:: ru.bitec.gs.automation.client.ui.dialog MsgDialog .. java:import:: ru.bitec.gs.automation.client.ui.layout.tab MdiPanel .. java:import:: ru.bitec.gs.automation.client.ui.menu ContextMenu Application =========== .. java:package:: ru.bitec.gs.automation.client.ui :noindex: .. java:type:: public class Application extends AbstractUiElement implements KeyboardInput .. versionadded:: 1.1.0 Методы и их сигнатуры приведены к :ref:`соглашению по именам`. Добавлены методы ожидания контекстного меню, получения панели MDI-вкладок, клика по body-элементу. Приложение, корневой элемент пользовательского интерфейса. Constructors ------------ Application ^^^^^^^^^^^ .. java:constructor:: public Application(BrowserContext browserContext, WebElement webElement) :outertype: Application Methods ------- bodyClick ^^^^^^^^^ .. java:method:: public void bodyClick() :outertype: Application .. versionadded:: 1.1.0 Метод выполняет клик мышкой в DOM-элемент body. Это действие позволяет "сбросить" фокусы, выделения и подобные состояния на интерфейсе. forms ^^^^^ .. java:method:: public AbstractForm[] forms() :outertype: Application Метод выполняет поиск всех форм открытых в приложении. :return: Массив форм get ^^^ .. java:method:: public static Application get(BrowserContext browserContext) throws org.openqa.selenium.NoSuchElementException :outertype: Application .. versionadded:: 1.1.0 Переименовано согласно :ref:`соглашению по именам` (ранее метод назывался find). Метод возвращает html-элемент, соответствующий :java:ref:`Application `, в дереве html-элементов браузера. :param browserContext: контекст браузера :throws org.openqa.selenium.NoSuchElementException: если приложение не найдено :return: Приложение getKeyboardInputWebElement ^^^^^^^^^^^^^^^^^^^^^^^^^^ .. java:method:: @Override public Optional getKeyboardInputWebElement() :outertype: Application Перенаправляет клавиатурные последовательности в dom-элемент window. :return: :java:ref:`Optional.empty() ` getServerAutomationSettings ^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. java:method:: public static Application.ServerAutomationSettings getServerAutomationSettings() :outertype: Application .. versionadded:: 1.1.1 Получить значения параметров автоматизации, сообщенные сервером приложений. :return: объект значений параметров автоматизации getServerVersion ^^^^^^^^^^^^^^^^ .. java:method:: public String getServerVersion() :outertype: Application Возвращает версию сервера приложений в формате: "Major.Minor.Release[-[ms|rc]Number]". Значение хранится в атрибуте :java:ref:`Attributes.DATA_SERVER_VERSION ` html-элемента. :return: версия getSessionId ^^^^^^^^^^^^ .. java:method:: public String getSessionId() :outertype: Application Возвращает идентификатор пользовательской сессии. Значение хранится в атрибуте :java:ref:`Attributes.DATA_SESSION_ID ` html-элемента. :return: идентификатор сессии lookupForm ^^^^^^^^^^ .. java:method:: public Form lookupForm(String name) throws ElementNotFoundException :outertype: Application .. versionadded:: 1.1.0 Сигнатура метода приведена к :ref:`соглашению по именам` (ранее выбрасывались исключения типа :java:ref:`NoSuchElementException `). Метод возвращает модальную форму, в режиме выбора значения, с указанным именем. :param name: Имя формы. **Примеры допустимых значений** * gtk-ru.company.module.Module_SelectionName#Representation * gtk-Module_SelectionName#Representation * ru.company.module.Module_SelectionName#Representation * Module_SelectionName#Representation Если значение не будет содержать имени отображения, будет использовано значение по умолчанию :java:ref:`Defaults.REPRESENTATION `. :throws ElementNotFoundException: если форма не найдена :return: Форма lookupForm ^^^^^^^^^^ .. java:method:: public Form lookupForm(String name, String representation) throws ElementNotFoundException :outertype: Application .. versionadded:: 1.1.0 Сигнатура метода приведена к :ref:`соглашению по именам` (ранее выбрасывались исключения типа :java:ref:`NoSuchElementException `). Метод возвращает модальную форму, в режиме выбора значения, с указанным именем. :param name: Имя главной выборки формы. **Примеры допустимых значений** * gtk-ru.company.module.Module_SelectionName * gtk-Module_SelectionName * ru.company.module.Module_SelectionName * Module_SelectionName :param representation: Отображение главной выборки формы. :throws ElementNotFoundException: если форма не найдена :return: Форма lookupForms ^^^^^^^^^^^ .. java:method:: public Form[] lookupForms() :outertype: Application Метод выполняет поиск всех модальных форм, в режиме выбора значения, открытых в приложении. :return: Массив форм mainForm ^^^^^^^^ .. java:method:: public MainForm mainForm() throws ElementNotFoundException :outertype: Application .. versionadded:: 1.1.0 Сигнатура метода приведена к :ref:`соглашению по именам` (ранее выбрасывались исключения типа :java:ref:`NoSuchElementException `). Метод возвращает главную форму приложения :java:ref:`MainForm `. :throws ElementNotFoundException: если форма не найдена :return: Главная форма mdiForm ^^^^^^^ .. java:method:: public Form mdiForm(String name) throws ElementNotFoundException :outertype: Application .. versionadded:: 1.1.0 Сигнатура метода приведена к :ref:`соглашению по именам` (ранее выбрасывались исключения типа :java:ref:`NoSuchElementException `). Метод возвращает MDI-форму с указанным именем. :param name: Имя формы. **Примеры допустимых значений** * gtk-ru.company.module.Module_SelectionName#Representation * gtk-Module_SelectionName#Representation * ru.company.module.Module_SelectionName#Representation * Module_SelectionName#Representation Если значение не будет содержать имени отображения, будет использовано значение по умолчанию :java:ref:`Defaults.REPRESENTATION `. :throws ElementNotFoundException: если форма не найдена :return: Форма mdiForm ^^^^^^^ .. java:method:: public Form mdiForm(String name, String representation) throws ElementNotFoundException :outertype: Application .. versionadded:: 1.1.0 Сигнатура метода приведена к :ref:`соглашению по именам` (ранее выбрасывались исключения типа :java:ref:`NoSuchElementException `). Метод возвращает MDI-форму с указанным именем. :param name: Имя главной выборки формы. **Примеры допустимых значений** * gtk-ru.company.module.Module_SelectionName * gtk-Module_SelectionName * ru.company.module.Module_SelectionName * Module_SelectionName :param representation: Отображение главной выборки формы. :throws ElementNotFoundException: если форма не найдена :return: Форма mdiForms ^^^^^^^^ .. java:method:: public Form[] mdiForms() :outertype: Application Метод возвращает все MDI-формы, открытые в приложении. :return: Массив форм mdipanel ^^^^^^^^ .. java:method:: public MdiPanel mdipanel() throws ElementNotFoundException :outertype: Application .. versionadded:: 1.1.0 Возвращает панель вкладок открытых MDI-форм приложения :java:ref:`MdiPanel `. :throws ElementNotFoundException: если панель не найдена :return: Панель вкладок открытых MDI-форм приложения. modalForm ^^^^^^^^^ .. java:method:: public Form modalForm(String name) throws ElementNotFoundException :outertype: Application .. versionadded:: 1.1.0 Сигнатура метода приведена к :ref:`соглашению по именам` (ранее выбрасывались исключения типа :java:ref:`NoSuchElementException `). Метод возвращает модальную форму с указанным именем. :param name: Имя формы. **Примеры допустимых значений** * gtk-ru.company.module.Module_SelectionName#Representation * gtk-Module_SelectionName#Representation * ru.company.module.Module_SelectionName#Representation * Module_SelectionName#Representation Если значение не будет содержать имени отображения, будет использовано значение по умолчанию :java:ref:`Defaults.REPRESENTATION `. :throws ElementNotFoundException: если форма не найдена :return: Форма modalForm ^^^^^^^^^ .. java:method:: public Form modalForm(String name, String representation) throws ElementNotFoundException :outertype: Application .. versionadded:: 1.1.0 Сигнатура метода приведена к :ref:`соглашению по именам` (ранее выбрасывались исключения типа :java:ref:`NoSuchElementException `). Метод возвращает модальную форму с указанным именем. :param name: Имя главной выборки формы. **Примеры допустимых значений** * gtk-ru.company.module.Module_SelectionName * gtk-Module_SelectionName * ru.company.module.Module_SelectionName * Module_SelectionName :param representation: Отображение главной выборки формы. :throws ElementNotFoundException: если форма не найдена :return: Форма modalForms ^^^^^^^^^^ .. java:method:: public Form[] modalForms() :outertype: Application Метод выполняет поиск всех модальных форм открытых в приложении. :return: Массив форм wait ^^^^ .. java:method:: public static Application wait(BrowserContext browserContext) throws org.openqa.selenium.TimeoutException :outertype: Application Метод выполняет ожидание появления html-элемента, соответствующего :java:ref:`Application `, в дереве html-элементов браузера. :param browserContext: контекст браузера :throws org.openqa.selenium.TimeoutException: если не дождались :return: Приложение wait ^^^^ .. java:method:: public static Application wait(BrowserContext browserContext, Duration duration) throws org.openqa.selenium.TimeoutException :outertype: Application Метод выполняет ожидание появления html-элемента, соответствующего :java:ref:`Application `, в дереве html-элементов браузера. :param browserContext: контекст браузера :param duration: длительность ожидания :throws org.openqa.selenium.TimeoutException: если не дождались :return: Приложение waitContextMenu ^^^^^^^^^^^^^^^ .. java:method:: public ContextMenu waitContextMenu() throws ElementNotFoundException :outertype: Application .. versionadded:: 1.1.0 Дождаться открытия контекстного меню :java:ref:`ContextMenu `. :throws ElementNotFoundException: если контекстное меню не найдено :return: контекстное меню. waitLookupForm ^^^^^^^^^^^^^^ .. java:method:: public Form waitLookupForm(String name) throws ElementNotFoundException :outertype: Application .. versionadded:: 1.1.0 Сигнатура метода приведена к :ref:`соглашению по именам` (ранее выбрасывались исключения типа :java:ref:`TimeoutException `). Метод выполняет ожидание открытия модальной формы, в режиме выбора значения, с указанным именем и возвращает эту форму. :param name: Имя формы. **Примеры допустимых значений** * gtk-ru.company.module.Module_SelectionName#Representation * gtk-Module_SelectionName#Representation * ru.company.module.Module_SelectionName#Representation * Module_SelectionName#Representation Если значение не будет содержать имени отображения, будет использовано значение по умолчанию :java:ref:`Defaults.REPRESENTATION `. :throws ElementNotFoundException: если не удалось дождаться lookup-форму :return: Форма waitLookupForm ^^^^^^^^^^^^^^ .. java:method:: public Form waitLookupForm(String name, String representation) throws ElementNotFoundException :outertype: Application .. versionadded:: 1.1.0 Сигнатура метода приведена к :ref:`соглашению по именам` (ранее выбрасывались исключения типа :java:ref:`TimeoutException `). Метод выполняет ожидание открытия модальной формы, в режиме выбора значения, с указанным именем и возвращает эту форму. :param name: Имя главной выборки формы. **Примеры допустимых значений** * gtk-ru.company.module.Module_SelectionName * gtk-Module_SelectionName * ru.company.module.Module_SelectionName * Module_SelectionName :param representation: Отображение главной выборки формы. :throws ElementNotFoundException: если не удалось дождаться lookup-форму :return: Форма waitLookupForm ^^^^^^^^^^^^^^ .. java:method:: public Form waitLookupForm(String name, String representation, Duration duration) throws ElementNotFoundException :outertype: Application .. versionadded:: 1.1.0 Сигнатура метода приведена к :ref:`соглашению по именам` (ранее выбрасывались исключения типа :java:ref:`TimeoutException `). Метод выполняет ожидание открытия модальной формы, в режиме выбора значения, с указанным именем и возвращает эту форму. :param name: Имя главной выборки формы. **Примеры допустимых значений** * gtk-ru.company.module.Module_SelectionName * gtk-Module_SelectionName * ru.company.module.Module_SelectionName * Module_SelectionName :param representation: Отображение главной выборки формы. :param duration: Длительность ожидания. :throws ElementNotFoundException: если не удалось дождаться lookup-форму :return: Форма waitMainForm ^^^^^^^^^^^^ .. java:method:: public MainForm waitMainForm() throws ElementNotFoundException :outertype: Application .. versionadded:: 1.1.0 Сигнатура метода приведена к :ref:`соглашению по именам` (ранее выбрасывались исключения типа :java:ref:`TimeoutException `). Метод выполняет ожидание открытия главной формы приложения :java:ref:`MainForm ` (применяется при открытии приложения) и возвращает эту форму. :throws ElementNotFoundException: если главная форма не открылась :return: Главная форма waitMdiForm ^^^^^^^^^^^ .. java:method:: public Form waitMdiForm(String name) throws ElementNotFoundException :outertype: Application .. versionadded:: 1.1.0 Сигнатура метода приведена к :ref:`соглашению по именам` (ранее выбрасывались исключения типа :java:ref:`TimeoutException `). Метод выполняет ожидание открытия MDI-формы с указанным именем и возвращает эту форму. Если форма уже открыта, или открыты несколько форм с одним именем, будет возвращена ссылка на первую найденную форму. :param name: Имя формы. **Примеры допустимых значений** * gtk-ru.company.module.Module_SelectionName#Representation * gtk-Module_SelectionName#Representation * ru.company.module.Module_SelectionName#Representation * Module_SelectionName#Representation Если значение не будет содержать имени отображения, будет использовано значение по умолчанию :java:ref:`Defaults.REPRESENTATION `. :throws ElementNotFoundException: если не удалось дождаться открытия Mdi-формы :return: Форма waitMdiForm ^^^^^^^^^^^ .. java:method:: public Form waitMdiForm(String name, String representation) throws ElementNotFoundException :outertype: Application .. versionadded:: 1.1.0 Сигнатура метода приведена к :ref:`соглашению по именам` (ранее выбрасывались исключения типа :java:ref:`TimeoutException `). Метод выполняет ожидание открытия MDI-формы с указанным именем и возвращает эту форму. Если форма уже открыта, или открыты несколько форм с одним именем, будет возвращена ссылка на первую найденную форму. :param name: Имя главной выборки формы. **Примеры допустимых значений** * gtk-ru.company.module.Module_SelectionName * gtk-Module_SelectionName * ru.company.module.Module_SelectionName * Module_SelectionName :param representation: Отображение главной выборки формы. :throws ElementNotFoundException: если не удалось дождаться открытия Mdi-формы :return: Форма waitMdiForm ^^^^^^^^^^^ .. java:method:: public Form waitMdiForm(String name, String representation, Duration duration) throws ElementNotFoundException :outertype: Application .. versionadded:: 1.1.0 Сигнатура метода приведена к :ref:`соглашению по именам` (ранее выбрасывались исключения типа :java:ref:`TimeoutException `). Метод выполняет ожидание открытия MDI-формы с указанным именем и возвращает эту форму. Если форма уже открыта, или открыты несколько форм с одним именем, будет возвращена ссылка на первую найденную форму. :param name: Имя главной выборки формы. **Примеры допустимых значений** * gtk-ru.company.module.Module_SelectionName * gtk-Module_SelectionName * ru.company.module.Module_SelectionName * Module_SelectionName :param representation: Отображение главной выборки формы. :param duration: Длительность ожидания. :throws ElementNotFoundException: если не удалось дождаться открытия Mdi-формы :return: Форма waitModalForm ^^^^^^^^^^^^^ .. java:method:: public Form waitModalForm(String name) throws ElementNotFoundException :outertype: Application .. versionadded:: 1.1.0 Сигнатура метода приведена к :ref:`соглашению по именам` (ранее выбрасывались исключения типа :java:ref:`TimeoutException `). Метод выполняет ожидание открытия модальной формы с указанным именем и возвращает эту форму. :param name: Имя формы. **Примеры допустимых значений** * gtk-ru.company.module.Module_SelectionName#Representation * gtk-Module_SelectionName#Representation * ru.company.module.Module_SelectionName#Representation * Module_SelectionName#Representation Если значение не будет содержать имени отображения, будет использовано значение по умолчанию :java:ref:`Defaults.REPRESENTATION `. :throws ElementNotFoundException: если не удалось дождаться модальную форму :return: Форма waitModalForm ^^^^^^^^^^^^^ .. java:method:: public Form waitModalForm(String name, String representation) throws ElementNotFoundException :outertype: Application .. versionadded:: 1.1.0 Сигнатура метода приведена к :ref:`соглашению по именам` (ранее выбрасывались исключения типа :java:ref:`TimeoutException `). Метод выполняет ожидание открытия модальной формы с указанным именем и возвращает эту форму. :param name: Имя главной выборки формы. **Примеры допустимых значений** * gtk-ru.company.module.Module_SelectionName * gtk-Module_SelectionName * ru.company.module.Module_SelectionName * Module_SelectionName :param representation: Отображение главной выборки формы. :throws ElementNotFoundException: если не удалось дождаться модальную форму :return: Форма waitModalForm ^^^^^^^^^^^^^ .. java:method:: public Form waitModalForm(String name, String representation, Duration duration) throws ElementNotFoundException :outertype: Application .. versionadded:: 1.1.0 Сигнатура метода приведена к :ref:`соглашению по именам` (ранее выбрасывались исключения типа :java:ref:`TimeoutException `). Метод выполняет ожидание открытия модальной формы с указанным именем и возвращает эту форму. :param name: Имя главной выборки формы. **Примеры допустимых значений** * gtk-ru.company.module.Module_SelectionName * gtk-Module_SelectionName * ru.company.module.Module_SelectionName * Module_SelectionName :param representation: Отображение главной выборки формы. :param duration: Длительность ожидания. :throws ElementNotFoundException: если не удалось дождаться модальную форму :return: Форма waitMsgDialog ^^^^^^^^^^^^^ .. java:method:: public MsgDialog waitMsgDialog() :outertype: Application Метод выполняет ожидание открытия модального диалога :java:ref:`MsgDialog ` с кнопками: OK, Да, Нет, Отмена и т.д.. :return: Диалог