AddCaption(sAdditional, [sLabel], [bExludeLabel], [sNumberingFormat], [bBefore], [nHeadingLvl], [sCaptionSep]) → { boolean }
Добавляет абзац заголовка после (или до) текущего абзаца.
Важно
Текущий абзац должен находиться в документе (а не в колонтитуле/шапке). А если текущий абзац помещается в фигуру, то подпись добавляется после (или перед) родительской фигурой.
Параметры
| Название | Тип | По умолчанию | Описание |
|---|---|---|---|
sAdditional | string | 0 | Дополнительный текст. |
sLabel | CaptionLabel | string | "Table" | Ярлык заголовка. |
bExludeLabel | boolean | false | Указывает, следует ли исключить метку из заголовка. |
sNumberingFormat | CaptionNumberingFormat | "Arabic" | Возможный формат нумерации подписей. |
bBefore | boolean | false | Указывает, следует ли вставлять подпись перед текущим абзацем (true) или после (false) (после/перед фигурой, если она размещена в фигуре). |
nHeadingLvl | number | null | Уровень заголовка (используется, если вы хотите указать номер главы). Если вы хотите указать «Заголовок 1», то |
sCaptionSep | CaptionSep | "hyphen" | Разделитель заголовков (используется, если вы хотите указать номер главы). |
Возвращает
boolean
Пример
builder.CreateFile("docx");
var oDocument = Api.GetDocument();
var oParagraph = oDocument.GetElement(0);
var oDrawing = Api.CreateImage("url-image.png", 60 * 36000, 35 * 36000);
oParagraph.AddDrawing(oDrawing);
oParagraph = Api.CreateParagraph();
oDocument.Push(oParagraph);
oParagraph.AddCaption("", "Figure", false, "Arabic", false, undefined, "hyphen");
builder.SaveFile("docx", "AddCaption.docx");
builder.CloseFile();
