Grid¶

public class Grid extends AbstractView implements Clickable, KeyboardInput ¶

Added in version 1.1.0: Добавлены методы получения некоторых свойств табличного представления. Добавлены методы получения строк, столбцов и ячеек. Поддержка мыши. Методы приведены в соответствие соглашению по именам.

Added in version 1.2.1: Добавлен доступ к объекту управления пользовательскими настройками

Список (табличное представление) - отображает данные выборки в виде таблицы/грида (набора строк с упорядочиванием значений атрибутов согласно последовательности колонок таким образом, что значение конкретного атрибута конкретной записи отображается в области пересечения известной строки и известной колонки, называемой ячейкой).

Содержит в себе методы, позволяющие получить доступ к строкам и колонкам. Так же позволяет получить некоторые характеристики табличного представления (такие, как признак возможности редактирования). Кроме того, реализует базовое взаимодействие посредством симуляции действий пользователя с помощью манипулятора типа “Мышь”.

Каждая строка выборки, после фильтрации и сортировки, уникальным образом адресуется целым числом, называемым далее “абсолютный номер”.

Получить строку по абсолютному номеру можно методом getRowByAbsoluteNumber(int).
Получить абсолютный номер выбранной строки можно методом getSelectedRowAbsoluteNumber().
Получить общее количество строк выборки можно методом getTotalCount().

В каждый момент времени, на табличном представлении отображается некоторое подмножество строк. Такие строки далее называются “видимые строки”.

Получить смещение до первой видимой строки можно методом getOffset()
Получить список видимых строк можно методом getRows()

Каждая отображаемая строка уникальным образом адресуется целым числом, называемым далее “видимый индекс” (getSelectedRowVisibleIndex()).

Получить строку по видимому индексу можно методом getRowByVisibleIndex(int).
Получить видимый индекс выбранной строки можно методом getSelectedRowVisibleIndex().

See also

Row
Rows
Column
Cell
Clickable

Constructors¶

Grid¶

protected Grid(Frame parent, WebElement webElement)¶

Grid¶

protected Grid(BrowserContext browserContext, WebElement webElement)¶

Methods¶

click¶

public void click()¶: Игнорируем клик в табличное представление. Интересуют только клики в строку или ячейку.

doubleClick¶

public void doubleClick()¶: Игнорируем дабл-клики в табличное представление. Интересуют только даблклики в строку или ячейку.

findGroupByName¶

public Optional<WebElement> findGroupByName(String name)¶

Added in version 1.2.1.

Получить dom-элемент колонки в области группировки по имени атрибута

Parameters:

name – имя атрибута

Returns:

опциональный dom-элемент колонки в области группировки

findSummaryArea¶

public Optional<WebElement> findSummaryArea()¶

Added in version 1.2.1.

Получить dom-элемент области итогов

Returns:: опциональный dom-элемент области итогов

findSummaryAreaColumn¶

public Optional<Clickable> findSummaryAreaColumn(int columnIndex)¶

Added in version 1.2.1.

Получить кликабельный dom-элемент колонки в области итогов по её номеру

Parameters:

columnIndex – номер колонки

Returns:

опциональный dom-элемент колонки в области итогов

findTableContainerElement¶

protected WebElement findTableContainerElement(WebDriverHelper driverHelper)¶

getCell¶

public Cell getCell(int rowVisibleIndex, String columnAttributeName)¶

Added in version 1.1.0.

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

Parameters:

rowVisibleIndex – видимый индекс строки табличного представления
columnAttributeName – название атрибута

Throws:

ElementNotFoundException – если не удалось получить строку таблицы

Returns:

ячейка

getCell¶

public Cell getCell(int rowVisibleIndex, int columnVisibleIndex)¶

Added in version 1.1.0.

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

Parameters:

rowVisibleIndex – видимый индекс строки
columnVisibleIndex – видимый индекс столбца

Throws:

ElementNotFoundException – если не удалось получить строку таблицы

Returns:

ячейка

getClickableWebElement¶

public WebElement getClickableWebElement()¶

Так как табличное представление может перерисоваться, при обработке кликов ищем заново кликабельный dom-элемент.

Returns:: кликабельный dom-элемент

getColumns¶

public Columns getColumns()¶

Added in version 1.1.0.

Получить колонки табличного представления.

Throws:

ElementNotFoundException – если не удалось получить колонки таблицы

Returns:

объект, содержащий колонки

getDynamicEditor¶

public WebElement getDynamicEditor()¶

Получить dom-элемент открытого динамического редактора.

Throws:

ElementNotFoundException – если не найден открытый динамический редактор

Returns:

dom-элемент динамического редактора

getGridMode¶

public Grid.Mode getGridMode()¶

Added in version 1.1.0.

Получить режим табличного представления.

Returns:: режим табличного представления Grid.Mode

getGroupArea¶

public Optional<WebElement> getGroupArea()¶

Added in version 1.2.1.

Получить dom-элемент области группировки, если она видима. Если она невидима, или dom-элемент отсутствует, вернёт java.util.Optional#empty()

Returns:: опциональный dom-элемент области группировки

getHorizontalScroller¶

public GridHorizontalScroller getHorizontalScroller()¶

Added in version 1.2.0.

Получить горизонтальную полосу прокрутки (скроллер) табличного представления.

Throws:

ElementNotFoundException – если не найдена горизонтальная полоса прокрутки табличного представления

Returns:

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

getKeyboardInputWebElement¶

public Optional<WebElement> getKeyboardInputWebElement()¶

getOffset¶

public int getOffset()¶

Added in version 1.1.0.

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

Returns:: номер строки или -1 если не удалось получить

See also

Grid

getParent¶

public Frame getParent()¶

getRowByAbsoluteNumber¶

public Row getRowByAbsoluteNumber(int absoluteNumber)¶

Added in version 1.1.0.

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

Parameters:

absoluteNumber – абсолютный номер строки (число от 0 до getTotalCount() - 1)

Throws:

ElementNotFoundException – если не удалось получить строки таблицы

Returns:

строка

See also

Grid
Rows
Row

getRowByVisibleIndex¶

public Row getRowByVisibleIndex(int visibleIndex)¶

Added in version 1.1.0.

Получить строку табличного представления из строк, отображающихся в гриде в текущий момент, по видимому индексу. Видимый индекс – число от 0 до <количество видимых строк> - 1.

Parameters:

visibleIndex – видимый индекс (число от 0 до <количество видимых строк> - 1)

Throws:

ElementNotFoundException – если не удалось получить строки таблицы

Returns:

строка

See also

Grid
Rows
Row

getRows¶

public Rows getRows()¶

Added in version 1.1.0.

Получить видимые строки табличного представления. Возвращает объект, предоставляющий методы для получения строк.

Returns:: объект строк табличного представления, предоставляющий доступ к видимым строкам

See also

Rows

getSelectedColumnVisibleIndex¶

public int getSelectedColumnVisibleIndex()¶

Added in version 1.1.0.

Получить видимый индекс столбца, в котором находится ячейка в состоянии “фокус”.

Returns:: видимый индекс столбца. -1, если не удалось определить такой столбец.

getSelectedRowAbsoluteNumber¶

public int getSelectedRowAbsoluteNumber()¶

Added in version 1.1.0.

Получить абсолютный номер строки, в которой находится ячейка в состоянии “фокус”.

Returns:: абсолютный номер строки. -1, если не удалось определить такую строку.

See also

Grid

getSelectedRowVisibleIndex¶

public int getSelectedRowVisibleIndex()¶

Added in version 1.1.0.

Получить видимый индекс строки, в которой находится ячейка в состоянии “фокус”.

Returns:: видимый индекс строки. -1, если не удалось определить такую строку.

See also

Grid

getTotalCount¶

public int getTotalCount()¶

Added in version 1.1.0.

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

Returns:: количество записей или -1 если не удалось получить количество записей.

See also

Grid

getUserSettings¶

public UserSettings getUserSettings()¶

Added in version 1.2.1.

Получить объект управления пользовательскими настройками списочного представления.

Returns:: объект управления пользовательскими настройками

See also

UserSettings

getVerticalSplitBar¶

public VerticalSplitBar getVerticalSplitBar()¶

Added in version 1.2.0.

Получить вертикальную разделительную полосу (сплит-бар), предназначенную для изменения ширины колонок.

Throws:

ElementNotFoundException – если не найдена вертикальная разделительная полоса

Returns:

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

getWindowSize¶

public int getWindowSize()¶

Added in version 1.1.0.

Получить ёмкость окна записей. Ёмкость – это максимальное количество записей выборки, подгруженных в текущий момент в табличное представление.

Следует ожидать, что количество подгруженных записей не равно количеству отображаемых записей.

Returns:: ёмкость окна или -1 если не удалось получить ёмкость.

See also

Grid

hasOpenDynamicEditor¶

public boolean hasOpenDynamicEditor()¶

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

Returns:: признак существования открытого динамического редактора.

isEditable¶

public boolean isEditable()¶

Added in version 1.1.0.

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

Returns:: признак редактируемости в табличном представлении

isPartialLoaded¶

public boolean isPartialLoaded()¶

Added in version 1.1.0.

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

Returns:: true, если данные списка загружены не полностью.

openContextMenu¶

public ContextMenu openContextMenu()¶

Added in version 1.2.1.

Открыть контекстное меню грида. Меню открывается симуляцией клика правой кнопкой мыши по гриду.

Throws:

ElementNotFoundException – если контекстное меню не появилось

Returns:

контекстное меню

populateProperties¶

protected void populateProperties()¶: Собирает из атрибутов dom-элемента табличного представления свойства табличного представления.

rightClick¶

public void rightClick()¶: Added in version 1.1.0.

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

wait¶

public static Grid wait(Frame parent)¶

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

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

Parameters:

parent – родительский фрейм

Returns:

Список

waitForColumnVisibilityDialog¶

public ColumnVisibilityDialog waitForColumnVisibilityDialog()¶

Added in version 1.2.1.

Метод выполняет ожидание dom-элемента окна настройки видимости колонок

Throws:

ElementNotFoundException – если диалог не открылся за отведенное время

Returns:

dom-элемент окна настройки видимости колонок

waitForDomStability¶

public void waitForDomStability()¶

Added in version 1.1.0.

Метод, позволяющий подождать отсутствия изменений графического состояния табличного представления (отсутствие изменений на dom-модели) в течении некоторого предопределенного времени.

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

waitForDomStability¶

public void waitForDomStability(Duration duration)¶

Added in version 1.1.0.

Метод, позволяющий подождать отсутствия изменений графического состояния табличного представления (отсутствие изменений на dom-модели) в течении указанного времени.

Parameters:

duration – продолжительность времени, в течении которой не должно происходить изменений на dom-дереве

waitTableElement¶

protected WebElement waitTableElement()¶