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

SetWidowControl(isWidowControl)

Унаследованный от: ApiParaPr#SetWidowControl

Указывает, будет ли одна строка текущего абзаца отображаться на отдельной странице от остального содержимого во время отображения путем перемещения строки на следующую страницу.

Параметры:

Название Тип Описание
isWidowControl логический Значение true означает, что одна строка текущего абзаца будет отображаться на отдельной странице от остального содержимого во время отображения путем перемещения строки на следующую страницу.

Возвращает:

Этот метод не возвращает никаких данных.

Пример

builder.CreateFile("docx");
var oDocument = Api.GetDocument();
var oParagraph = oDocument.GetElement(0);
oParagraph.AddText("The single line of the last paragraph on this page will be prevented from being displayed on a separate page. ");
for (let x = 0; x < 5; ++x) {
  oParagraph = Api.CreateParagraph();
  for (let i = 0; i < 10; ++i) {
    oParagraph.AddText("These sentences are used to add lines for demonstrative purposes. ");
  }
  oDocument.Push(oParagraph);
}
oParagraph = Api.CreateParagraph();
for (let i = 0; i < 4; ++i) {
  oParagraph.AddText("These sentences are used to add lines for demonstrative purposes. ");
}
oParagraph.SetWidowControl(true);
oParagraph.AddText("This last line is displayed on the next page, because we used the set widow control method set to 'true'.");
oDocument.Push(oParagraph);
builder.SaveFile("docx", "SetWidowControl.docx");
builder.CloseFile();