DOCUMENT:Q172105  13-AUG-1997  [vbwin]
TITLE   :BUG: NewPage Method Followed by EndDoc Method Prints Blank Page
PRODUCT :Microsoft Visual Basic for Windows
PROD/VER:WINDOWS:5.0
OPER/SYS:WINDOWS
KEYWORDS:vb5all VBKBPrinting

======================================================================
---------------------------------------------------------------------
The information in this article applies to:

 - Microsoft Visual Basic Control Creation, Learning, Professional, and
   Enterprise Editions for Windows, version 5.0
---------------------------------------------------------------------

SYMPTOMS
========

If a call is made to the EndDoc method of the Printer Object (or the
application is closed) after having issued the NewPage method, a page is
ejected from the printer regardless of whether any actual printing has
taken place.

This is contrary to the behavior of Visual Basic 4.0, as well as the online
Help in Visual Basic 5.0 for the EndDoc method, which states the following:

   If EndDoc is invoked immediately after the NewPage method, no additional
   blank page is printed.

STATUS
======

Microsoft has confirmed this to be a bug in the Microsoft products
listed at the beginning of this article. We are researching this
bug and will post new information here in the Microsoft Knowledge
Base as it becomes available.

MORE INFORMATION
================

Steps to Reproduce Behavior
---------------------------

1. Create a new project.

2. Add a CommandButton to Form1.

3. Add the following code to Form1:

      Private Sub Command1_Click()
         Printer.Print "Page 1"
         Printer.NewPage
         Printer.EndDoc
      End Sub

4. Press the F5 key to run the project.

5. Click the button. Note that two pages are printed. The first page prints
   as expected, but it is followed by a blank page.

REFERENCES
==========

Visual Basic 5.0 Online Help for the EndDoc Method
======================================================================
Keywords          : vb5all VBKBPrinting
Version           : WINDOWS:5.0
Platform          : WINDOWS
Issue type        : kbbug

=============================================================================

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS
PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.  MICROSOFT DISCLAIMS
ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  IN NO
EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR
ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL,
CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF
MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.  SOME STATES DO NOT ALLOW THE EXCLUSION
OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES
SO THE FOREGOING LIMITATION MAY NOT APPLY.

Copyright Microsoft Corporation 1997.