APPNOTE: PW0778: Printing Self-Study Module

• Microsoft Windows Software Development Kit (SDK) for Windows version 3.1

SUMMARY

This application note is a self-study module created by Microsoft Technical Support Worldwide Training to help software engineers develop expertise in Windows printing.

To obtain this application note (PW0778),"Printing Self-Study Guide," call Microsoft Technical Support.

Download PW0778.EXE, a self-extracting file, from the Microsoft Software Library (MSL) on the following services:

• Microsoft Download Service (MSDL)

        Dial (206) 936-6735 to connect to MSDL
        Download PW0778.EXE (size: 813563 bytes) 
  

• Internet (anonymous FTP)

        ftp ftp.microsoft.com
        Change to the SOFTLIB\MSLFILES directory
        Get PW0778.EXE (size: 813563 bytes) 
  

MORE INFORMATION

       Microsoft(R) Technical Support Application Note (Text File)
                  PW0778: PRINTING SELF-STUDY MODULE

                                                   Revision Date: 4/94
                                                       1 Disk Included

| INFORMATION PROVIDED IN THIS DOCUMENT AND ANY SOFTWARE THAT MAY     |
| ACCOMPANY THIS DOCUMENT (collectively referred to as an Application |
| Note) IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER      |
| EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED      |
| WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR       |
| PURPOSE. The user assumes the entire risk as to the accuracy and    |
| the use of this Application Note. This Application Note may be      |
| copied and distributed subject to the following conditions:  1) All |
| text must be copied without modification and all pages must be      |
| included;  2) If software is included, all files on the disk(s)     |
| must be copied without modification (the MS-DOS(R)  utility         |
| diskcopy is appropriate for this purpose);  3) All components of    |
| this Application Note must be distributed together;  and  4) This   |
| Application Note may not be distributed for profit.                 |
|                                                                     |
| Copyright (C) 1993-1994 Microsoft Corporation. All Rights Reserved. |
| Microsoft and MS-DOS are registered trademarks and Windows is a     |
| trademark of Microsoft Corporation.                                 |
|---------------------------------------------------------------------|

ABOUT THIS COURSE

This self-study course is one of a series of courses developed by Microsoft Technical Support Worldwide Training to help software engineers develop expertise in areas of Windows that they have not previously explored. The course focuses on common programming errors, common troubleshooting scenarios, documentation errors, and Windows issues, in addition to common application programming techniques. This course was designed and the technical content supplied by engineers who provide developers with Windows programming support. The information included here has been determined by these specialists to be what you need to know about this topic in order to successfully implement it into your application.

WHAT YOU WILL LEARN

After completing this course, you will:

Use direct calls to the Windows Application Programming Interface (API) to:

    - Create and use printer device contexts (DCs).
    - Query printer device capabilities.
    - Use common printer escapes.
    - Implement an abort function.
    - Perform printing as a background process.
    - Implement an abort dialog.
    - Generate simple printed output using GDI primitives.
    - Print using banding techniques.
    - Call functions in the printer driver.
    - Print using the features new to Windows version 3.1.

INSTALLING THE SELF-STUDY MODULE

First, copy PW0778.EXE to the directory that the course is to be installed in. Change to that directory and enter the following command:

   PW0778

   class -d

Directory Structure

The directory structure that is created has a LABS subdirectory and a TRAINING subdirectory. The TRAINING subdirectory contains a help file for the self-study course, a compiled version of the sample code, and a .DLL (dynamic-link library) for the Print All feature. The LABS subdirectory contains a subdirectory for each of the labs used in this course. In each of the individual lab subdirectories there is a DONECODE and a BASECODE subdirectory. The BASECODE subdirectory contains the code for the lab; the student modifies this code to get the desired results. The DONECODE directory contains the code for the solutions to the lab.

Getting Started

Once you have successfully installed the self-study module, run Windows and bring up the File Manager. Go to the TRAINING subdirectory in the directory that you installed the self-study module in and double-click the PRINTING.HLP file. This will run the Windows Help engine and load the self-study module. You are now ready to begin the course.

Print All Feature

This self-study course has the option to "Print All" (a choice from the File menu). This menu selection prints the entire contents of the .HLP file containing the course.

   NOTE: Due to design limitations of the Help engine, there is no way
   to abort this feature and all hardware input will be disabled while
   printing all. In addition, you cannot "print to file" using this
   feature; the print job MUST go directly to the printer.