Click here to Skip to main content
16,019,140 members
Articles / Multimedia / GDI+
Article

Screen Capturing

Rate me:
Please Sign up or sign in to vote.
4.77/5 (46 votes)
24 Mar 20062 min read 264.8K   3.2K   224   48
Capture screen contents without using any Win32 API calls, just using .NET (2.0) classes.

Demo application

Introduction

There are a lot of articles about screen capturing, but most of them use Win32 API functions, even in .NET 2.0, where this is not necessary because .NET 2.0 has all classes needed to implement that.

Background

It's often necessary to get a screenshot of the entire screen or parts of it. In our applications, we often use systems with multiple monitors, requiring us to capture all of them at once or each screen separately. Just remember, the virtual screen is the complete view of all monitors attached to the system, the primary screen is the view of the main monitor, and the working screen is the same but excluding the task bar.

Using the code

The class 'ScreenCapture' supplies a couple of methods allowing to capture the complete virtual screen, the primary screen, the working screen, a specific form (complete or only the client area), and only the contents of a specific control in a form. The images captured may be used directly from your code, or they can be saved into a file or printed. There is another small helper class 'ImageFormatHandler' which is used to handle the different graphic file formats when saving the captured image.

The source

The source code files include the two classes described, and may be directly used in your code. It's built with Visual Studio 2005.

Our main capturing method looks like below:

C#
public Bitmap[] Capture( CaptureType typeOfCapture )
{
    // used to capture then screen in memory
    Bitmap memoryImage;
    // number of screens to capture,
    // will be updated below if necessary
    int count = 1;

    try
    {
        Screen[] screens = Screen.AllScreens;
        Rectangle rc;

        // setup the area to capture
        // depending on the supplied parameter
        switch ( typeOfCapture )
        {
            case CaptureType.PrimaryScreen:
                rc = Screen.PrimaryScreen.Bounds;
                break;
            case CaptureType.VirtualScreen:
                rc = SystemInformation.VirtualScreen;
                break;
            case CaptureType.WorkingArea:
                rc = Screen.PrimaryScreen.WorkingArea;
                break;
            case CaptureType.AllScreens:
                count = screens.Length;
                typeOfCapture = CaptureType.WorkingArea;
                rc = screens[0].WorkingArea;
                break;
            default:
                rc = SystemInformation.VirtualScreen;
                break;
        }
        // allocate a member for saving the captured image(s)
        images = new Bitmap[count];

        // cycle across all desired screens
        for ( int index = 0; index < count; index++ )
        {
            if ( index > 0 )
                rc = screens[index].WorkingArea;
                // redefine the size on multiple screens

            memoryImage = new Bitmap( rc.Width, rc.Height, 
                          PixelFormat.Format32bppArgb );
            using ( Graphics memoryGrahics = 
                    Graphics.FromImage( memoryImage ) )
            {
                // copy the screen data
                // to the memory allocated above
                memoryGrahics.CopyFromScreen( rc.X, rc.Y, 
                   0, 0, rc.Size, CopyPixelOperation.SourceCopy );
            }
            images[index] = memoryImage;
            // save it in the class member for later use
        }
    }
    catch ( Exception ex )
    {
        // handle any erros which occured during capture
        MessageBox.Show( ex.ToString(), "Capture failed", 
            MessageBoxButtons.OK, MessageBoxIcon.Error );
    }
    return images;
}

The variable images used is a member of this class, and is of type Bitmap[]. The parameter typeOfCapture of this method is an enum type defined in this class, and is used to select what actually should be captured.

There is another capture method which is used to selectively capture the contents of controls, forms, or their client area. It works quite similar to the one shown above.

C#
private Bitmap capture( Control window, Rectangle rc )
{
    Bitmap memoryImage = null;
    images = new Bitmap[1];

    // Create new graphics object using handle to window.
    using ( Graphics graphics = window.CreateGraphics() )
    {
        memoryImage = new Bitmap( rc.Width, 
                      rc.Height, graphics );

        using ( Graphics memoryGrahics = 
                Graphics.FromImage( memoryImage ) )
        {
            memoryGrahics.CopyFromScreen( rc.X, rc.Y, 
               0, 0, rc.Size, CopyPixelOperation.SourceCopy );
        }
    }
    images[0] = memoryImage;
    return memoryImage;
}

Several other methods are used to do all the work needed for saving/printing the captured image, they are all described in comments in the source code.

C#
public void Save( String filename, 
       ImageFormatHandler.ImageFormatTypes format )

The parameter filename holds the desired name with a complete path, the extension will be substituted depending on the file type selected by the parameter format.

This methods loads some parameters depending on the file format chosen:

C#
ImageCodecInfo info;
EncoderParameters parameters = 
  formatHandler.GetEncoderParameters( format, out info );

That's where we use the helper class ImageFormatHandler which does all that. I think this is a base which can be used for customizing to your own needs.

Changes

The actual example has been updated by some method, which can be used to capture screens from other processes; to do that, native code must be used. Then it is no longer a pure .NET 2.0 solution. We also did not test this solution with layered forms, but a bit of modification in the base capturing method should enable this.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


Written By
Software Developer (Senior) Retired
Germany Germany
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
GeneralNice work ! Pin
BillWoodruff6-Feb-06 19:57
professionalBillWoodruff6-Feb-06 19:57 
GeneralOther programs window Pin
theDiver31-Jan-06 21:45
theDiver31-Jan-06 21:45 
GeneralRe: Other programs window Pin
Holzhauer1-Feb-06 5:57
Holzhauer1-Feb-06 5:57 
GeneralRe: Other programs window Pin
wduros17-Feb-06 5:33
wduros17-Feb-06 5:33 
GeneralRe: Other programs window Pin
Holzhauer7-Feb-06 6:35
Holzhauer7-Feb-06 6:35 
GeneralRe: Avoid Win32 API? You are kidding right? Pin
Mark Belles29-Mar-06 19:19
Mark Belles29-Mar-06 19:19 
GeneralRe: Avoid Win32 API? You are kidding right? Pin
Holzhauer29-Mar-06 19:39
Holzhauer29-Mar-06 19:39 
GeneralRe: Other programs window Pin
Kirk Horne9-Mar-06 11:15
Kirk Horne9-Mar-06 11:15 
This works - to an extent. What I am seeing however is that if the process is not the current topmost window, the CopyFromScreen will create an image of the correct size/location but of the topmost window.

Thus far, I have only been able to find a solution to print a window (regardless of it's z-order) in unmanaged C++. Unfortunate.
GeneralRe: Other programs window Pin
Holzhauer9-Mar-06 21:28
Holzhauer9-Mar-06 21:28 
GeneralRe: Other programs window Pin
Kirk Horne10-Mar-06 5:51
Kirk Horne10-Mar-06 5:51 
GeneralRe: Other programs window Pin
The_Mega_ZZTer24-Mar-06 11:40
The_Mega_ZZTer24-Mar-06 11:40 
GeneralRe: Other programs window Pin
Brennon Williams7-Apr-06 0:34
Brennon Williams7-Apr-06 0:34 

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.