Row¶

public final class Row extends AbstractUiElement implements Clickable ¶: Added in version 1.1.0.

Added in version 1.1.3: Добавлена поддержка табличных представлений в карточном режиме.

Added in version 1.2.0: Добавлены методы получения ширин ячеек строки: getCellWidths(), getCellWidths(int...) и getCellWidths(String...).

Строка табличного представления. Представление записи в виде строки таблицы.

See also

Rows

Grid

Cell

Clickable

Constructors¶

Row¶

Row(Grid parent, WebElement webElement, int rowVisibleIndex)¶

Row¶

Row(Grid parent, WebElement webElement, int rowVisibleIndex, Supplier<WebElement> elementResolver)¶

Methods¶

click¶

public void click(boolean stayInColumn)¶

Added in version 1.1.0.

Послать клик левой кнопкой мыши в строку. Дефолтный Clickable.click() посылает клик в геометрический центр строки, что может привести к изменению текущей колонки. Что не всегда желательно.

Parameters:

stayInColumn – признак сохранения позиции. Если true – будет осуществлен клик в соответствующую ячейку строки. Если false – будет осуществлен дефолтный Clickable.click().

click¶

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

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

See also

click(boolean)

clickTreeNodeToggle¶

public void clickTreeNodeToggle()¶

Added in version 1.2.1.

Кликнуть по значку раскрытия узла древовидного табличного представления: свёрнутый узел раскрывается, раскрытый - сворачивается.

Узел переключает только клик по значку: клик в остальную часть строки делает её текущей, не трогая узел.

Throws:

ru.bitec.gs.automation.exception.AutomationException – если клик не удалось выполнить за отведённое время

doubleClick¶

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

findCellElements¶

public List<WebElement> findCellElements()¶

Получить список dom-элементов ячеек строки.

Returns:: список dom-элементов ячеек строки

getAttributeName¶

String getAttributeName()¶

Added in version 1.1.3.

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

Returns:: название атрибута

getCellByName¶

public Cell getCellByName(String name)¶

Added in version 1.1.3: Метод отключен для табличных представлений в карточном режиме

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

Parameters:

name – название атрибута

Throws:

ElementNotFoundException – если не удалось найти ячейку с указанным именем атрибута
GridModeException – если табличное представление находится в карточном режиме

Returns:

ячейка

getCellByVisibleIndex¶

public Cell getCellByVisibleIndex(int columnVisibleIndex)¶

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

Parameters:

columnVisibleIndex – видимый индекс колонки

Throws:

IndexOutOfBoundsException – если columnVisibleIndex меньше 0
ElementNotFoundException – если не найдена ячейка с указанным видимым индексом

Returns:

ячейка

getCellWidths¶

public int[] getCellWidths()¶

Added in version 1.2.0.

Получить ширины всех ячеек строки.

Ширины извлекаются с помощью JavaScript (element.getBoundingClientRect().width), что обеспечивает высокую производительность при большом числе ячеек.

Returns:: массив ширин ячеек строки (в пикселях) в порядке их отображения

getCellWidths¶

public int[] getCellWidths(int... cellVisibleIndexes)¶

Added in version 1.2.0.

Получить ширины ячеек строки, найденных по их видимому индексу. Ширины извлекаются с помощью JavaScript (element.getBoundingClientRect().width), что обеспечивает высокую производительность при большом числе ячеек.

Parameters:

cellVisibleIndexes – видимые индексы ячеек строки

Returns:

массив ширин ячеек строки (в пикселях) в порядке переданных видимых индексов

getCellWidths¶

public int[] getCellWidths(String... attributeNames)¶

Added in version 1.1.3: Метод отключен для табличных представлений в карточном режиме

Added in version 1.2.0.

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

Parameters:

attributeNames – имена атрибутов

Throws:

ElementNotFoundException – если ячейка строки с указанным атрибутом не найдена
GridModeException – Если табличное представление находится в карточном режиме

Returns:

массив ширин ячеек строки (в пикселях) в порядке переданных атрибутов

getCells¶

public List<Cell> getCells()¶

Получить список ячеек строки.

Returns:: список ячеек строки

getEditorType¶

EditorTypeEnum getEditorType()¶

Added in version 1.1.3.

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

Returns:: тип редактора

getRowVisibleIndex¶

public int getRowVisibleIndex()¶

Получить видимый индекс строки.

Returns:: видимый индекс строки

getTreeNodeCaption¶

public String getTreeNodeCaption()¶

Added in version 1.2.1.

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

В отличие от Cell.value(), читает весь текст ячейки: перед значением в ячейке узла стоит блок с отступом и значками, и значение, которое ячейка ищет по позиции, приходит из этого блока пустым. Узел дерева всегда отрисован в первой видимой колонке.

Throws:

ElementNotFoundException – если ячейка узла не отрисована за отведённое время

Returns:

наименование узла

getTreeNodeLevel¶

public int getTreeNodeLevel()¶

Added in version 1.2.1.

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

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

Throws:

NoSuchElementException – если строка не относится к древовидному табличному представлению

Returns:

уровень узла, у корневого узла - 0

getWebElement¶

public WebElement getWebElement()¶

Added in version 1.2.1.

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

Строка это локатор, пока сохранённая ссылка валидна, она отдаётся как есть, а как только табличное представление отрисовало строку заново, ссылка разыскивается по тому же адресу, по которому строка была получена изначально. Ожидание отрисовки выполняет сам локатор, поэтому вызывающему знать о состоянии табличного представления не требуется.

Throws:

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

Returns:

dom-элемент строки

hasTreeNodeIndentArrow¶

public boolean hasTreeNodeIndentArrow()¶

Added in version 1.2.1.

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

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

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

isTreeNodeExpanded¶

public boolean isTreeNodeExpanded()¶

Added in version 1.2.1.

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

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

Throws:

NoSuchElementException – если строка не относится к древовидному табличному представлению

Returns:

true, если узел раскрыт

resolveCellElement¶

WebElement resolveCellElement(int columnVisibleIndex)¶

Added in version 1.2.1.

Получить dom-элемент ячейки строки по видимому индексу колонки, дожидаясь его отрисовки.

Parameters:

columnVisibleIndex – видимый индекс колонки

Throws:

IndexOutOfBoundsException – если columnVisibleIndex меньше 0
ElementNotFoundException – если ячейка не отрисована за отведённое время

Returns:

dom-элемент ячейки