.. java:import:: org.openqa.selenium WebElement

.. java:import:: ru.bitec.gs.automation.client BrowserContext

.. java:import:: ru.bitec.gs.automation.client.ui AbstractUiElement

AbstractMenu
============

.. java:package:: ru.bitec.gs.automation.client.ui.menu
   :noindex:

.. java:type:: public abstract class AbstractMenu extends AbstractUiElement

   .. versionadded:: 1.1.0 Методы и сигнатуры приведены к :ref:`соглашению по именам<gsauto_namingconvensions>`.

   Абстрактное меню.

   .. seealso::

      | :java:ref:`MainMenu <ru.bitec.gs.automation.client.ui.menu.MainMenu>`
      | :java:ref:`ContextMenu <ru.bitec.gs.automation.client.ui.menu.ContextMenu>`
      | :java:ref:`MenuItem <ru.bitec.gs.automation.client.ui.menu.MenuItem>`

Constructors
------------

AbstractMenu
^^^^^^^^^^^^

.. java:constructor:: protected AbstractMenu(AbstractUiElement parent, WebElement webElement)
   :outertype: AbstractMenu

AbstractMenu
^^^^^^^^^^^^

.. java:constructor:: protected AbstractMenu(BrowserContext browserContext, WebElement webElement)
   :outertype: AbstractMenu

Methods
-------

item
^^^^

.. java:method:: public MenuItem item(String operationName) throws ElementNotFoundException
   :outertype: AbstractMenu

   .. versionadded:: 1.1.0 Метод приведен к :ref:`соглашению по именам<gsauto_namingconvensions>` (ранее метод не выполнял ожидания появления пункта меню на dom-модели).

   Метод выполняет поиск пункта меню, соответствующего операции с указанным именем.

   :param operationName: имя операции выборки
   :throws ElementNotFoundException: если не удалось получить пункт меню
   :return: пункт меню

item
^^^^

.. java:method:: public MenuItem item(String... operationNames) throws ElementNotFoundException
   :outertype: AbstractMenu

   .. versionadded:: 1.1.0 Метод приведен к :ref:`соглашению по именам<gsauto_namingconvensions>` (ранее метод не выполнял ожидания появления пунктов меню и подменю на dom-модели).

   Метод выполняет последовательный поиск пунктов меню, соответствующих операциям с указанными именами.

   Для каждого не последнего пункта выполняется "клик", для раскрытия под меню.

   :param operationNames: имена операций
   :throws ElementNotFoundException: если какой-то из пунктов меню не был найден
   :return: пункт меню, соответсвующий операции с последним именем.

itemByCaption
^^^^^^^^^^^^^

.. java:method:: public MenuItem itemByCaption(String caption) throws ElementNotFoundException
   :outertype: AbstractMenu

   .. versionadded:: 1.1.0 Метод приведен к :ref:`соглашению по именам<gsauto_namingconvensions>` (ранее метод не выполнял ожидания появления пункта меню на dom-модели).

   Метод выполняет поиск пункта меню, соответствующего операции с указанным наименованием.

   :param caption: наименование
   :throws ElementNotFoundException: если не удалось получить пункт меню
   :return: пункт меню

itemByCaption
^^^^^^^^^^^^^

.. java:method:: public MenuItem itemByCaption(String... captions) throws ElementNotFoundException
   :outertype: AbstractMenu

   .. versionadded:: 1.1.0 Метод приведен к :ref:`соглашению по именам<gsauto_namingconvensions>` (ранее метод не выполнял ожидания появления пунктов меню и подменю на dom-модели).

   Метод выполняет последовательный поиск пунктов меню, соответствующих операциям с указанными наименованиями.

   Для каждого не последнего пункта выполняется "клик", для раскрытия подменю.

   :param captions: наименования пунктов меню
   :throws ElementNotFoundException: если какой-то из пунктов меню не был найден
   :return: пункт меню, соответсвующий операции с последним наименованием.

waitByCaption
^^^^^^^^^^^^^

.. java:method:: public MenuItem waitByCaption(String caption) throws ElementNotFoundException
   :outertype: AbstractMenu

   .. versionadded:: 1.1.0 Метод приведен к :ref:`соглашению по именам<gsauto_namingconvensions>` (ранее метод назывался findByCaption).

   Метод выполняет ожидание html-элемента, соответствующего :java:ref:`MenuItem <ru.bitec.gs.automation.client.ui.menu.MenuItem>` с указанным наименованием операции,
   в дереве html-элементов браузера, ограниченном указанным родительски элементом.

   :param caption: наименование операции выборки
   :throws ElementNotFoundException: если не дождались появления html-элемента
   :return: пункт меню

waitByOperation
^^^^^^^^^^^^^^^

.. java:method:: public MenuItem waitByOperation(String operationName) throws ElementNotFoundException
   :outertype: AbstractMenu

   .. versionadded:: 1.1.0 Метод приведен к :ref:`соглашению по именам<gsauto_namingconvensions>` (ранее метод назывался findByOperation).

   Метод выполняет ожидание html-элемента, соответствующего :java:ref:`MenuItem <ru.bitec.gs.automation.client.ui.menu.MenuItem>` с указанным именем операции,
   в дереве html-элементов браузера, ограниченном указанным родительски элементом.

   :param operationName: имя операции выборки
   :throws ElementNotFoundException: если не дождались появления html-элемента
   :return: пункт меню