Skip to main content

Метод Position.insertTextBox

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

info

Данный метод позволяет добавить текстовое поле:

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

Вызов​


 insertTextBox(String text, SizeU size)

Параметры​

‒ text – текст внутри текстового поля;

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

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

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

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


 TextBox = document.getRange().getBegin().insertTextBox("Text", myOfficeSDK.SizeU(100.0, 100.0))

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


 headers = section.getHeaders()
 for header in headers:
   headerRange = header.getRange()
   position = headerRange.getBegin()
   position.insertTextBox("Text", myOfficeSDK.SizeU(100.0, 100.0))

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


 table = document.getBlocks().getTable(0)
 cell = table.getCell("A1")
 range = cell.getRange()
 begin = range.getBegin()
 TextBox = begin.insertTextBox("Text", myOfficeSDK.SizeU(100.0, 100.0))