• Post category:ApiParagraph
  • Запись изменена:12.11.2022

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();