| Control Reference > VSPrinter Control > VSPrinter Methods > EndOverlay Method |
Closes a page that was opened with the StartOverlay method.
[form!]VSPrinter.EndOverlay
The StartOverlay and EndOverlay methods allow you to add elements to a document after it has been created in preview mode.
This allows you to create templates with blank fields, save them to disk, load and fill them out later. It also allows you to avoid lengthy two-pass operations. With the StartOverlay and EndOverlay methods, you can create the document, save information you need (such as page numbers, counts, and subtotals), then go back and place the information in the appropriate places.
Each page in the document may have a single overlay page. To create the overlay page, you issue the StartOverlay method with the desired page as a parameter, then add all text and graphics elements that you want, and finalize the overlay by calling the EndOverlay method.
When you call StartOverlay, you have the option of preserving or deleting the contents of the previous overlay for the page.
See also the Page n of m example.