Продукты Р7
Корпоративный сервер 2024
Корпоративный сервер 2024
Сервер документов
Сервер документов
Редакторы
Редакторы
Корпоративный сервер 2019
Корпоративный сервер 2019
Графика
Графика
Команда
Команда
Мобильные редакторы
Мобильные редакторы
Облачный офис
Облачный офис
Почта
Почта
Органайзер
Органайзер
Дополнительно
Часто задаваемые вопросы
Разработчикам
Интеграции
Новые возможности

AddNumberedCrossRef

Обновлено: 15.12.25

AddNumberedCrossRef(sRefType, oParaTo, [bLink], [bAboveBelow], [sSepWith]) → { boolean }

Добавляет пронумерованную перекрестную ссылку к текущему абзацу.

Абзац должен находиться в документе.

Параметры:

Название Тип По умолчанию Описание
sRefType numberedRefTo Текстовое или числовое значение нумерованной ссылки, которую вы хотите вставить.
oParaTo ApiParagraph Пронумерованный параграф, на который необходимо сослаться (должен быть в документе).
bLink логический true Указывает, будет ли ссылка вставлена в виде гиперссылки.
bAboveBelow логический false Указывает, следует ли включать слова above/below, указывающие на позицию ссылки (не используется с sRefType «text» и «aboveBelow»)
sSepWith строковый «» Разделитель чисел (используется только с sRefType «fullCtxParaNum»).

Возвращает:

Логический тип

Пример

builder.CreateFile("docx");
var oDocument = Api.GetDocument();
var oNumbering = oDocument.CreateNumbering("numbered");
for (let nLvl = 0; nLvl < 8; ++nLvl) {
  var oNumLvl = oNumbering.GetLevel(nLvl);
  var sFormatString = "";
  for (let nTempLvl = 0; nTempLvl <= nLvl; ++nTempLvl) sFormatString += "%" + nTempLvl + ".";
  oNumLvl.SetCustomType("lowerRoman", sFormatString, "left");
  oNumLvl.SetStart(nLvl + 1);
  oNumLvl.SetSuff("space");
  var oParagraph = Api.CreateParagraph();
  oParagraph.AddText("Custom numbered lvl " + (nLvl + 1));
  oParagraph.SetNumbering(oNumLvl);
  oParagraph.SetContextualSpacing(true);
  oDocument.Push(oParagraph);
}
var aNumberedParagraphs = oDocument.GetAllNumberedParagraphs();
oParagraph = Api.CreateParagraph();
oParagraph.AddText("An example of the customized numbering type can be found in the paragraph № ");
oDocument.Push(oParagraph);
oParagraph.AddNumberedCrossRef("paraNum", aNumberedParagraphs[1], true, true);
builder.SaveFile("docx", "AddNumberedCrossRef.docx");
builder.CloseFile();