2019.2

paginate()
This method of the section object (see "section" on page907) triggers pagination of the current
section. The pagination process re-establishes page boundaries, updates page numbers and
page counts, and reapplies Master Pages.
Depending on whether page numbering restarts in each section this may affect the page
numbers in other sections as well (see "Configuring page numbers" on page152).
When the pagination process has ended, the script resumes.
The 'current section' is always a Print section, since this method can only be used in Post
Pagination Scripts, and Post Pagination Scripts only run on the Print context (see "Post
Pagination Scripts" on page426).
You only need to call merge.section.paginate() in a Post Pagination Script if the script has
added or removed content to such an extent that the page boundaries need to be renewed.
For an example see: "Creating a Table Of Contents" on page428.
Pagination
The Pagination object that is accessed via the section object (see "section" on page907)
contains the total page count, sheet count and start/end page numbers for a single section.
These properties are read-only and are only available in Post Pagination Scripts (see "Post
Pagination Scripts" on page426).
For the total page and sheet count of all Print sections together use the merge object's
"Pagination" on page918 (see also: "merge" on the next page).
For information about where an element is located and the counts of pages and sheets in a
page bundle - a group of sections in which the page numbering continues - use "info()" on
page906.
Field Type Description
pageCount Number The total number of pages in this section.
pageEnd Number
The index (1-based) of the last page in this section.
pageStart Number The index (1-based) of the first page in this section.
Page 916