BUG: Must Call API to Print Color Text on Color Printer in VB (84269)



The information in this article applies to:

  • Microsoft Visual Basic Standard Edition for Windows 2.0
  • Microsoft Visual Basic Standard Edition for Windows 3.0
  • Microsoft Visual Basic Professional Edition for Windows 2.0
  • Microsoft Visual Basic Professional Edition for Windows 3.0
  • Microsoft Visual Basic Standard Edition for Windows 1.0

This article was previously published under Q84269

SYMPTOMS

Visual Basic for Windows does not directly support printing text in color to a color printer.

WORKAROUND

To print in color, you must first make a call to the Windows API function SetTextColor(). The example below shows how to implement this call into a Visual Basic application to allow for printing of colored text.

STATUS

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

MORE INFORMATION

The ForeColor property of the Printer object was not fully implemented in Visual Basic. You can set the property, but the setting has no effect.

To send color output to a color printer, you must use the Windows API function call SetTextColor() instead of the ForeColor property of the Printer object.

Do the following to print "Hello" in all of the 16 QBColors:
  1. Start Visual Basic or from the File menu, choose New Project (ALT, F, N) if Visual Basic is already running. Form1 is created by default.
  2. In the Form1 global module, add the following:
       ' Enter the following Declare statement on one, single line:
       Declare Function SetTextColor Lib "GDI" (ByVal hDC As Integer,
          ByVal crColor As Long) As Long
    
    						
  3. In the Form1 Form_Click event procedure, add the following code:
       Sub Form_Click
          For i = 0 to 15
             x& = SetTextColor(Printer.HDC, QBColor(i))
             Printer.Print "Hello"
          Next i
          Printer.EndDoc
       End Sub
    
    						
  4. Press F5 to run the program. Click the form.
The word "hello" will print in 16 different colors.

Modification Type:MajorLast Reviewed:12/12/2003
Keywords:kbbug KB84269