Skip to main content

Метод Position.insertShape

Вставляет фигуру заданного типа в текущую позицию. Возвращает объект Shape, содержащий вставленную фигуру.

info

Данный метод позволяет добавить фигуру:

  • в позицию текстового документа, в том числе в header/footer;
  • в позицию текста ячейки таблицы текстового документа кроме случая, когда таблица находится внутри фигуры: в этом случае вставка запрещена.

Вызов​


 insertShape(PresetGeometryType geometryType, SizeU size)

Параметры​

‒ geometryType – вид фигуры, тип PresetGeometryType;

‒ size – геометрические размеры фигуры для вставки.

Возвращаемые ошибки​

  • NotImplementedError при вызове метода не из текстового документа;
  • DocumentModificationError при заблокированном контенте текстового документа;
  • NotImplementedError при попытке вставить внутри фигуры, в том числе в таблице;
  • NotImplementedError при вставке в footnote/endnote.

Пример вставки фигуры в позицию текстового документа​


 var shape = document.getRange().getBegin().insertShape(PresetGeometryType.Triangle, new SizeU(100.0, 100.0));

Пример вставки фигуры в заголовок (header) текстового документа​


 var headers = section.getHeaders();
 HeadersEnumerator headersEnumerator = headers.getEnumerator();
 foreach (var header in headersEnumerator)
 {
    var headerRange = header.getRange();
    var position = headerRange.getBegin();
    position.insertShape(PresetGeometryType.Triangle, new SizeU(100.0, 100.0));
 }

Пример вставки фигуры в ячейку таблицы текстового документа​


 var table = document.getBlocks().getTable(0);
 var cell = table.getCell("A1");
 var range = cell.getRange();
 var begin = range.getBegin();
 var shape = begin.insertShape(PresetGeometryType.Triangle, new SizeU(100.0, 100.0));