Skip to main content

Класс CellRangePosition

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

Объект типа CellRangePositionинициализируется конструкторами:


 CellRangePosition()
 CellRangePosition(CellPosition topLeftArg, CellPosition bottomRightArg)

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

 CellRangePosition(std::size_t topLeftRow, std::size_t topLeftColumn, std::size_t bottomRightRow, std::size_t bottomRightColumn)

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

Примеры​


 Table table = document.getBlocks().getTable(0).get();
 CellRangePosition cellRangePosition = CellRangePosition(0, 0, 5, 5);
 CellRange range = table.getCellRange(cellRangePosition);
 Table table = document.getBlocks().getTable(0).get();
 Charts charts = table.getCharts();
 ChartRangeInfo rangeInfo = charts.getChart(0).getRange(0);
 TableRangeInfo cellRangePosition = rangeInfo.tableRangeInfo;
 CellRangePosition tableRange = cellRangePosition.tableRange;
 std::printf("topLeft=%d, %d", tableRange.topLeft.row, tableRange.topLeft.column);
 std::printf("bottomRight=%d, %d", tableRange.bottomRight.row, tableRange.bottomRight.column);