keepWithNext property

ParagraphFormat.keepWithNext property

True if the paragraph is to remains on the same page as the paragraph that follows it.

get keepWithNext(): boolean

Examples

Shows how to set a table to stay together on the same page.

let doc = new aw.Document(base.myDir + "Table spanning two pages.docx");
let table = doc.firstSection.body.tables.at(0);

// Enabling KeepWithNext for every paragraph in the table except for the
// last ones in the last row will prevent the table from splitting across multiple pages.
for (var cellNode of table.getChildNodes(aw.NodeType.Cell, true)) {
  var cell = cellNode.asCell();
  for (let para of cell.paragraphs.toArray())
  {
    expect(para.isInCell).toEqual(true);

    if (!(cell.parentRow.isLastRow && para.isEndOfCell))
      para.paragraphFormat.keepWithNext = true;
  }
}

doc.save(base.artifactsDir + "Table.KeepTableTogether.docx");

keepWithNext property

ParagraphFormat.keepWithNext property

Examples

See Also