Skip to main content

Метод Table.ensureSize

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

Вызов​


 public ensureSize(string cellRef)

 public ensureSize(CellPosition cellPosition)

Параметры​

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

Ошибки​

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

Примеры​


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

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