Click here to Skip to main content
15,880,469 members
Articles / Desktop Programming / MFC

Easy to Use Class for ScreenCapture to Printer

Rate me:
Please Sign up or sign in to vote.
4.14/5 (29 votes)
9 May 2004CPOL3 min read 168.6K   3.9K   38   62
A class for easily capturing screen and printing to default printer

Introduction

For a project I'm working on, I needed a way to easily create screen shots of the foreground dialog and to print the image directly to the default printer. As I couldn't find the right solution ready for use, I wrote a quick 'n dirty own class, based on the many articles found at The Code Project.

The attached code builds a very easy to use screen capture function, which can be called in a button callback for example. It is possible to adjust the capture area and the print orientation. The desired area will be captured and printed.

Using the Code

As said, one of the aims was to make the class as easy to use as possible.

  1. Add the files PrntScreen.cpp and PrntScreen.h to your project.
  2. In your application (or dialog class, etc.), add the following line:
    C++
    #include "PrntScreen.h"
  3. At the place, where you want to capture and print the screen, add the following lines to your code:

    Example 1:

    C++
    CPrntScreen * ScrCap;
    ScrCap = new CPrntScreen();  //create instance
    ScrCap->DoPrntScreen();  //execute capture function
    delete ScrCap;  //remove instance
    ScrCap=NULL;

    Example 2:

    C++
    CPrntScreen * ScrCap;
    ScrCap = new CPrntScreen("Some error occurred!!!","Message");
    ScrCap->DoPrntScreen(1,1,true);
    delete ScrCap;
    ScrCap=NULL;

Example 1 uses just the default parameters, whereas Example 2 uses available options.

Description

Constructor

The constructor of the class is defined as CPrntScreen(char* sErrTxt, char* sCaption), thus accepting two parameters. The idea was to permit customizing the error message box for your own needs/language.

Description of the parameters:

  • char* sErrTxt = pointer to characters pointing to a desired error message
  • char* sCaption = pointer to characters pointing to a desired message box caption
    if the parameters are omitted, the default text/caption will be shown in case of an error.

Functions

The class contains just one function, DoPrntScreen(int nArea, int nOrientation, bool bDialog).
Description of the parameters:

  • nArea determines the area of screen to be captured, with:
    • 0 = Whole screen
    • 1 = Foreground window
    • 2 = Foreground window - Client area
      If parameter is omitted, 0 (Whole Screen) will be used by default
  • nOrientation determines the print orientation, with:
    • 1 = Portrait (you may also use DMORIENT_PORTRAIT)
    • 2 = Landscape (you may also use DMORIENT_LANDSCAPE)
      This parameter is only used, if bDialog=false
      If parameter is omitted, 2 (Portrait) will be used by default
  • bDialog controls, if a printer dialog will be shown:
    • false = Use default printer without showing dialog
    • true = Show printer dialog
      If parameter is omitted, false (Default Printer) will be used by default

History

  • Version 1.0: First version
  • Version 1.1: Updated version
    Following changes where done:
    • Defined default parameters for even easier use (see example 1 above)
    • Introduced a flag for enabling the use of the printer dialog
    • Changed the stretching function. Now the captured area will be stretched to printer page in the relation, it has to the whole screen. Capturing of smaller dialogs will not anymore cause huge printouts. :) Having done this, it is definitely best to set print orientation to landscape!
    • The above changes are compatible to the old version, thus no code change is needed when using the new version. Just drop in the new code. Only the printout may change proportions, due to the change of stretching. :(
  • Version 1.1A: Bug fix, fixing an error which caused empty pages on some printers
  • Version 1.2: Bug fix (hopefully) and new features. This new version includes:
    • The code suggested by Dieter Hammer, which should eliminate that nasty blank page problem
    • Correct printing of dialogs, which were partially pushed out of desktop area
    • Proportional correct printout, independent of paper orientation
    • Checking, if printer is actually capable of printing images
    • And I have added a demo project. The prj file is for VC7, sorry, I don't have VC6 anymore. Just look to the last callback handlers in "PrintDlg.cpp"

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Engineer
Brazil Brazil
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
QuestionTitle Bar is not updating Pin
Dan Welfle28-Nov-16 10:46
Dan Welfle28-Nov-16 10:46 
AnswerRe: Title Bar is not updating Pin
Albert Hermann28-Sep-17 3:35
Albert Hermann28-Sep-17 3:35 
GeneralMy vote of 3 Pin
diqiudiguo11-Sep-13 21:57
diqiudiguo11-Sep-13 21:57 
QuestionLicensing Terms Pin
Scott Bartine8-Dec-11 5:44
Scott Bartine8-Dec-11 5:44 
AnswerRe: Licensing Terms Pin
a. hermann15-Dec-11 0:16
a. hermann15-Dec-11 0:16 
AnswerRe: Licensing Terms Pin
Albert Hermann15-Dec-11 0:45
Albert Hermann15-Dec-11 0:45 
GeneralNO MOVE DIALOG Pin
csanmartin220-Nov-06 5:51
csanmartin220-Nov-06 5:51 
GeneralRe: NO MOVE DIALOG Pin
Albert Hermann20-Nov-06 8:10
Albert Hermann20-Nov-06 8:10 
GeneralRe: NO MOVE DIALOG Pin
csanmartin220-Nov-06 21:32
csanmartin220-Nov-06 21:32 
GeneralSome problems faced Pin
dacylet1-Mar-06 4:12
dacylet1-Mar-06 4:12 
GeneralDetected memory leaks! Pin
l00p1n626-Feb-06 2:40
l00p1n626-Feb-06 2:40 
GeneralA bug? OS=Win98 Pin
Lemonx22-Feb-06 15:26
Lemonx22-Feb-06 15:26 
GeneralGreat work & little question... Pin
Alberto_Canabal11-Jan-06 2:59
Alberto_Canabal11-Jan-06 2:59 
GeneralRe: Great work & little question... Pin
Albert Hermann11-Jan-06 6:57
Albert Hermann11-Jan-06 6:57 
GeneralThank you so much! Pin
yeunri7-Sep-05 20:12
yeunri7-Sep-05 20:12 
Jokewow 2 - really easy to use Pin
Stephan Simson25-Aug-05 4:07
Stephan Simson25-Aug-05 4:07 
GeneralA little problem, memory leak Pin
Member 39017293-Jul-05 22:03
Member 39017293-Jul-05 22:03 
GeneralRe: A little problem, memory leak Pin
Albert Hermann4-Jul-05 1:03
Albert Hermann4-Jul-05 1:03 
GeneralIntercepting a print job Pin
AlexEvans2-Jul-05 16:43
AlexEvans2-Jul-05 16:43 
GeneralRe: Intercepting a print job Pin
Albert Hermann4-Jul-05 1:09
Albert Hermann4-Jul-05 1:09 
GeneralGreat Code Pin
Macca187-Jun-05 4:42
Macca187-Jun-05 4:42 
GeneralRe: Great Code Pin
Albert Hermann7-Jun-05 5:59
Albert Hermann7-Jun-05 5:59 
GeneralAmazing job!!!! Pin
DP TWO13-May-05 10:24
DP TWO13-May-05 10:24 
GeneralRe: Amazing job!!!! Pin
Albert Hermann7-Jun-05 6:04
Albert Hermann7-Jun-05 6:04 
GeneralGreat! One suggestion Pin
a.damm28-Apr-05 20:00
a.damm28-Apr-05 20:00 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.