Skip to main content

Метод Table::ensureSize

Метод предназначен для расширения рабочей области таблицы до заданной позиции в случае, если в этом есть необходимость. В качестве параметра передается адрес ячейки. В случае, если адрес ячейки уже находится в рабочей области таблицы, не происходит ничего. В случае необходимости уменьшения рабочей области можно воспользоваться методами Table::removeRow(), Table::removeColumn(), Table::removeVisibleRows(), Table::removeVisibleColumns().

Вызов​


 ensureSize(std::string cellRef)

 ensureSize(CellPosition cellPosition)

Параметры​

  • cellRef: адрес ячейки в текстовом формате, например, "A1", тип std::string;
  • cellPosition: адрес ячейки, тип CellPosition.

Ошибки​

  • в случае вызова метода не из табличного документа возникает исключение NotImplementedError;
  • в случае, если включена защита листа на вставку строк или столбцов, возникает исключение SpreadsheetProtectionError;
  • в случае невозможности модифицировать документ по причине превышения максимального значения ряда или колонки, возникает исключение DocumentModificationError.
  • в случае неправильного формата ячейки возникает исключение ParseError.

Примеры​


 Table table = document.getBlocks().getTable(0).get();

 table.ensureSize("A10");
 table.ensureSize(DocumentAPI.CellPosition(10, 0));