Skip to main content

Таблица DocumentAPI.CellRangePosition

Таблица DocumentAPI.CellRangePosition представляет положение диапазона ячеек в таблице. Объект DocumentAPI.CellRangePosition используется в методах Table:getCellRange(), CellRange:getTableRange() и Chart:setRange(). По умолчанию диапазон включает одну ячейку в позиции 0,0 что соответствует верхней левой ячейке таблицы для редактора текста, либо ячейке А1 для редактора таблиц.

Конструкторы​


 CellRangePosition()
 CellRangePosition(topLeftArg, bottomRightArg)

  • topLeftArg – позиция левой верхней ячейки диапазона, тип CellPosition;
  • bottomRightArg – позиция правой нижней ячейки диапазона, тип CellPosition.

 CellRangePosition(topLeftRow, topLeftColumn, bottomRightRow, bottomRightColumn)

  • topLeftRow – индекс верхней строки диапазона (индексация начинается с нуля), тип number;
  • topLeftColumn – индекс левого столбца диапазона, тип number;
  • bottomRightRow – индекс нижней строки диапазона, тип number;
  • bottomRightColumn – индекс правого столбца диапазона, тип number.
ПолеТипОписание
CellRangePosition.topLeftCellPositionПозиция левой верхней ячейки таблицы прямоугольного диапазона. Значение 0,0 соответствует верхней левой ячейке таблицы для редактора текста, либо ячейке А1 для редактора таблиц.
CellRangePosition.bottomRightCellPositionСодержит позицию правой нижней ячейки таблицы прямоугольного диапазона.

Примеры​


 local table = document:getBlocks():getTable(0)
 local leftTopCellPosition = DocumentAPI.CellPosition(0, 0)
 local rightBottomCellPosition = DocumentAPI.CellPosition(5, 5)
 local cellRangePosition = DocumentAPI.CellRangePosition(leftTopCellPosition, rightBottomCellPosition)
 local range = table:getCellRange(cellRangePosition)
 local table = document:getBlocks():getTable(0)
 local cellRangePosition = DocumentAPI.CellRangePosition(0, 0, 5, 5)
 local range = table:getCellRange(cellRangePosition)
 local tbl = document:getBlocks():getTable(0)
 local charts = tbl:getCharts()
 local rangeInfo = charts:getChart(0):getRange(0)
 local cellRangePosition = rangeInfo.tableRangeInfo.tableRange
 print("topLeft=", cellRangePosition.topLeft.row, cellRangePosition.topLeft.column)
 print("bottomRight=", cellRangePosition.bottomRight.row, cellRangePosition.bottomRight.column)