Microsoft KB Archive/27728

PRB: Documentation Error on the Use of NEWFRAME and NEXTBAND ID Number: Q27728

2.00 2.03 2.10 3.00 WINDOWS docerr

SYMPTOMS The NEXTBAND section on page 25 of the “Microsoft Windows 2.00 Software Development Kit Update” incorrectly states that Escape(…NEWFRAME…) should be called after the last NEXTBAND on a page. When this command sequence is followed, extra blank pages are generated.

RESOLUTION NEWFRAME and NEXTBAND are exclusive; an application must call one or the other, however, both should never be called. When using NEWFRAME, the call must be placed at the bottom of every page to output the page and start a new page.

Microsoft has confirmed this to be a documentation error on Page 25 of the “Microsoft Windows 2.00 Software Development Kit Update”. We will post new information here when this error has been corrected.

More Information:

Please note that ENDDOC and ABORTDOC are also exclusive. ABORTDOC is used when it is necessary to abort the document (for example, the application has detected an error or the Print command is cancelled). Some output may have already been sent to the device at the time of the ABORTDOC, however, any additional output will be discarded. ENDDOC is used to close and send a completed document.