pageStartingNumber property
PageSetup.pageStartingNumber property
Gets or sets the starting page number of the section.
get pageStartingNumber(): number
Remarks
The PageSetup.restartPageNumbering property, if set to false, will override the
PageSetup.pageStartingNumber property so that page numbering can continue from the previous section.
Examples
Shows how to set up page numbering in a section.
let doc = new aw.Document();
let builder = new aw.DocumentBuilder(doc);
builder.writeln("Section 1, page 1.");
builder.insertBreak(aw.BreakType.PageBreak);
builder.writeln("Section 1, page 2.");
builder.insertBreak(aw.BreakType.PageBreak);
builder.writeln("Section 1, page 3.");
builder.insertBreak(aw.BreakType.SectionBreakNewPage);
builder.writeln("Section 2, page 1.");
builder.insertBreak(aw.BreakType.PageBreak);
builder.writeln("Section 2, page 2.");
builder.insertBreak(aw.BreakType.PageBreak);
builder.writeln("Section 2, page 3.");
// Move the document builder to the first section's primary header,
// which every page in that section will display.
builder.moveToSection(0);
builder.moveToHeaderFooter(aw.HeaderFooterType.HeaderPrimary);
// Insert a PAGE field, which will display the number of the current page.
builder.write("Page ");
builder.insertField("PAGE", "");
// Configure the section to have the page count that PAGE fields display start from 5.
// Also, configure all PAGE fields to display their page numbers using uppercase Roman numerals.
let pageSetup = doc.sections.at(0).pageSetup;
pageSetup.restartPageNumbering = true;
pageSetup.pageStartingNumber = 5;
pageSetup.pageNumberStyle = aw.NumberStyle.UppercaseRoman;
// Create another primary header for the second section, with another PAGE field.
builder.moveToSection(1);
builder.moveToHeaderFooter(aw.HeaderFooterType.HeaderPrimary);
builder.paragraphFormat.alignment = aw.ParagraphAlignment.Center;
builder.write(" - ");
builder.insertField("PAGE", "");
builder.write(" - ");
// Configure the section to have the page count that PAGE fields display start from 10.
// Also, configure all PAGE fields to display their page numbers using Arabic numbers.
pageSetup = doc.sections.at(1).pageSetup;
pageSetup.pageStartingNumber = 10;
pageSetup.restartPageNumbering = true;
pageSetup.pageNumberStyle = aw.NumberStyle.Arabic;
doc.save(base.artifactsDir + "PageSetup.PageNumbering.docx");
See Also
- module Aspose.Words
- class PageSetup