ToolBar¶

public class ToolBar extends AbstractUiElement ¶: Added in version 1.1.0: Методы приведены к соглашению по именам (см. описания методов класса).

Added in version 1.1.3: Добавлены свойства отображения панели инструментов (ToolBar.Orientation, ToolBar.IconAlign). Добавлена поддержка выпадающих меню.

Added in version 1.2.1: Добавлены методы findButton(String), findButton(StandardOperations), findButtonByCaption(String), hasButton(String), hasButton(StandardOperations) и hasButtonByCaption(String).

Тулбар - панель инструментов. Содержит на себе операции, визуально представленные в виде кнопок ToolButton.

See also

ToolButton

Constructors¶

ToolBar¶

public ToolBar(Selection selection, WebElement webElement)¶

Панель инструментов не всегда принадлежит фрейму Frame. Тулбар может принадлежать компоновщику Composer.

Parameters:

selection – Выборка
webElement – Web-элемент

Methods¶

button¶

public ToolButton button(String operationName)¶

Added in version 1.1.0: Метод приведен к соглашению по именам (ранее метод не выполнял ожидания появления кнопки на dom-модели и выбрасывалось исключение типа NoSuchElementException).

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

Parameters:

operationName – имя операции выборки

Throws:

ElementNotFoundException – если кнопка не обнаружена на dom-модели или не появилась на dom-дереве в течение времени ее ожидания

Returns:

кнопка панели инструментов

button¶

public ToolButton button(StandardOperations operation)¶

Added in version 1.1.0.

Метод ожидает появления (Defaults.getDurationWaitElement()) и возвращает кнопку панели инструментов, соответствующую указанной стандартной операции.

Parameters:

operation – стандартная операция выборки

Throws:

ElementNotFoundException – если кнопка не обнаружена или не появилась на dom-дереве в течение времени ее ожидания

Returns:

кнопка панели инструментов

buttonByCaption¶

public ToolButton buttonByCaption(String caption)¶

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

Parameters:

caption – наименование операции выборки

Throws:

ElementNotFoundException – если кнопка не обнаружена или не появилась на dom-дереве в течение времени ее ожидания

Returns:

кнопка панели инструментов

findButton¶

public Optional<ToolButton> findButton(String operationName)¶

Added in version 1.2.1.

Найти кнопку панели инструментов по названию операции. Метод не выполняет ожидание появления кнопки (Defaults.getDurationWaitElement()).

Parameters:

operationName – название операции

Returns:

опциональная кнопка панели инструментов

findButton¶

public Optional<ToolButton> findButton(StandardOperations operation)¶

Added in version 1.2.1.

Найти кнопку панели инструментов по стандартной операции. Метод не выполняет ожидание появления кнопки (Defaults.getDurationWaitElement()).

Parameters:

operation – операция

Returns:

опциональная кнопка панели инструментов

findButtonByCaption¶

public Optional<ToolButton> findButtonByCaption(String caption)¶

Added in version 1.2.1.

Найти кнопку панели инструментов по наименованию. Метод не выполняет ожидание появления кнопки (Defaults.getDurationWaitElement()).

Parameters:

caption – наименование

Returns:

опциональная кнопка панели инструментов

getIconAlign¶

public ToolBar.IconAlign getIconAlign()¶

Added in version 1.1.3.

Возвращает тип выравнивания иконки (ToolBar.IconAlign) в кнопках панели инструментов.

Returns:: тип выравнивания иконки или ToolBar.IconAlign.Unknown если не указана.

getOrientation¶

public ToolBar.Orientation getOrientation()¶

Added in version 1.1.3.

Возвращает ориентацию ToolBar.Orientation панели инструментов.

Returns:: ориентация или ToolBar.Orientation.Unknown если не указана.

hasButton¶

public boolean hasButton(String operationName)¶

Added in version 1.2.1.

Проверить наличие кнопки на панели инструментов по названию операции. Метод не выполняет ожидание появления кнопки (Defaults.getDurationWaitElement()).

Parameters:

operationName – название операции

Returns:

true если кнопка присутствует на панели инструментов, иначе: false

hasButton¶

public boolean hasButton(StandardOperations operation)¶

Added in version 1.2.1.

Проверить наличие кнопки на панели инструментов по стандартной операции. Метод не выполняет ожидание появления кнопки (Defaults.getDurationWaitElement()).

Parameters:

operation – операция

Returns:

true если кнопка присутствует на панели инструментов, иначе: false

hasButtonByCaption¶

public boolean hasButtonByCaption(String caption)¶

Added in version 1.2.1.

Проверить наличие кнопки на панели инструментов по наименованию. Метод не выполняет ожидание появления кнопки (Defaults.getDurationWaitElement()).

Parameters:

caption – наименование

Returns:

true если кнопка присутствует на панели инструментов, иначе: false

wait¶

public static ToolBar wait(Selection parent)¶

Added in version 1.1.0: Метод переименован согласно соглашению по именам (ранее метод назывался find).

Метод выполняет ожидание появление html-элемента, соответствующего ToolBar, в дереве html-элементов браузера и возвращает его.

Parameters:

parent – родительская выборка

Throws:

ElementNotFoundException – если панель инструментов не обнаружена или не отобразилась на dom-дереве в течение времени ее ожидания

Returns:

панель инструментов