Page - Form Output Operation (Magic xpa 3.x)
This property determines Magic xpa's behavior whenever an End of Page state occurs, which is relevant for reports to a Printer only. It is not relevant for Merge forms.
The End of Page (EOP) state occurs when the output form is larger than the space remaining on the current page. The page size (number of lines) that Magic xpa uses for evaluating the EOP state is logical, and is not related to the physical page size of any printer. You can use the Printer repository to establish the relationship between the printer's physical and Magic xpa's logical page sizes. This logical page size is determined by one of the following:
-
The Rows property of the I/O device associated with the Form Output operation.
-
If the Row value is not specified, you can use the Lines property specified for the printer associated with the current Form Output operation's I/O device.
The End of Page state is cleared by the next Form Output operation that causes a page jump. Form Output operations specifying Automatic or Top (see below) clear the EOP state indicator.
Because Magic xpa allows simultaneous output to multiple I/O devices and output media, the End of Page state is specific for each operating system text file. Therefore, an End of Page state on one I/O device does not affect any Form Output operations to other I/O devices.
The Page property has three possible values:
Auto (for Automatic) – This is the default. When Auto is specified, before printing the current form, Magic xpa checks if there is sufficient space left on the current page to accommodate the form in full. If enough space is available, Magic xpa prints the form on the current page. If there is not enough space, Magic xpa handles the end of the page automatically by jumping to a new page and printing the form on the new page.
If there are Header forms of the same class as the current form, Magic xpa will first print the Header forms and then will print the current form.
Skip – When Skip is specified before printing the current form to the output file, Magic xpa checks if there is sufficient space left on the current page to accommodate the form in full. If enough space is available, Magic xpa writes the form to the output media. Otherwise, it skips the form and does not write it to the output media. Instead, the End of Page state indicator is switched on. You can query this indicator with the EOP function.
Top – When Top is specified, Magic xpa issues a form feed to the printer before sending the form for printing. This causes the form to be printed on the top of a new page. This is a way to force page breaks. In this case, the Headers are not automatically reprinted.
|
Note:
|
It is up to you, as a developer, to define what action should be taken based on an End of Page state. For example, you can force a page break, using a Form Output operation with Top as its Page setting, and continue with normal output.
|
When the End of Page state occurs, any further output of forms using Skip mode will be ignored. Output with Skip mode will resume when the EOP state is cleared.
Use Skip mode for applications where you require complete control over output. In such cases, you can condition Form Output operations based on the EOP and Line functions.
SpecialPrintWhiteTillEOP
