Skip to main content

Метод Table:ensureSize

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

Вызов​


 ensureSize(string cellRef)

 ensureSize(CellPosition cellPosition)

Параметры​

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

Ошибки​

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

Примеры​


 table = document:getBlocks():getTable(0)

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