Click here to Skip to main content
16,021,687 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 265K   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

 
QuestionSource code not available Pin
Bharat Mendapara23-Aug-15 21:33
Bharat Mendapara23-Aug-15 21:33 
AnswerRe: Source code not available Pin
Member 355851816-May-16 14:27
Member 355851816-May-16 14:27 
GeneralRe: Source code not available Pin
MineEric6428-Feb-21 6:35
MineEric6428-Feb-21 6:35 
QuestionNice Work Pin
jemang2-Jan-12 16:06
jemang2-Jan-12 16:06 
GeneralScreen Capturing in VB.Net Pin
Mother of 818-May-11 17:20
Mother of 818-May-11 17:20 
GeneralCapture screen in different ways, object wise, rectangle wise etc. Pin
yogesh_softworld12313-Oct-09 0:52
yogesh_softworld12313-Oct-09 0:52 
GeneralThanks Pin
KennShipley19-Jun-09 10:21
KennShipley19-Jun-09 10:21 
GeneralJust what I was looking for Pin
Captainobvious29-Sep-08 5:37
Captainobvious29-Sep-08 5:37 
Generalabout minimize the window Pin
zac_cn116-Jan-08 18:00
zac_cn116-Jan-08 18:00 
GeneralThanks for your work Pin
mistnick11-Jan-08 4:03
mistnick11-Jan-08 4:03 
QuestionI need the help please Pin
Ali Habib23-Nov-07 6:55
Ali Habib23-Nov-07 6:55 
Generalcapture Window with alpha Pin
Gallo_Teo8-May-07 7:26
Gallo_Teo8-May-07 7:26 
GeneralCapturing on local system account Pin
biszkopt11-Mar-07 5:55
biszkopt11-Mar-07 5:55 
QuestionHow to ... Pin
suneel_sp6-Mar-07 19:03
suneel_sp6-Mar-07 19:03 
GeneralAlphablended windows Pin
fouloud9-Dec-06 22:48
fouloud9-Dec-06 22:48 
Generalexported screen capture function Pin
jb706040526-Sep-06 7:56
jb706040526-Sep-06 7:56 
AnswerRe: exported screen capture function Pin
Holzhauer26-Sep-06 19:56
Holzhauer26-Sep-06 19:56 
QuestionCapturing, No problem... but can you draw? Pin
John Storer II7-Sep-06 16:59
John Storer II7-Sep-06 16:59 
AnswerRe: License Information Pin
Holzhauer24-Aug-06 21:03
Holzhauer24-Aug-06 21:03 
QuestionLicense Information Pin
smartsarna24-Aug-06 8:26
smartsarna24-Aug-06 8:26 
QuestionRe: License Information Pin
Nikhil_777713-Feb-09 6:48
Nikhil_777713-Feb-09 6:48 
GeneralCapture process screen without changing his Z-ORDER Pin
asafbenzaken2-Jul-06 7:25
asafbenzaken2-Jul-06 7:25 
GeneralCode used in ASP.Net Pin
as_mahadevan31-May-06 1:23
as_mahadevan31-May-06 1:23 
QuestionHow it is possible through ASP.NET Pin
as_mahadevan31-May-06 1:15
as_mahadevan31-May-06 1:15 
GeneralKurzform Pin
Dave305222-Apr-06 22:19
Dave305222-Apr-06 22:19 
Für die die nur wissen wollen wie man einen Screenshot macht, hier die Kurzform:

<br />
using System.Drawing;<br />
using System.Drawing.Imaging;<br />
<br />
...<br />
<br />
Rectangle rc = Screen.PrimaryScreen.Bounds;<br />
Bitmap memoryImage = new Bitmap(rc.Width, rc.Height, PixelFormat.Format32bppArgb);<br />
using (Graphics memoryGrahics = Graphics.FromImage(memoryImage))<br />
{<br />
    memoryGrahics.CopyFromScreen(rc.X, rc.Y, 0, 0, rc.Size, CopyPixelOperation.SourceCopy);<br />
}<br />
memoryImage.Save(@"C:\capture.png", ImageFormat.Png);<br />


Wer das Bild nicht direkt auf die Festplatte speichern sondern weiterbearbeiten will, der ersetzt die memoryImage.Save-Zeile im Code durch folgende Zeilen:
<br />
System.IO.MemoryStream OutStream = new System.IO.MemoryStream();<br />
memoryImage.Save(OutStream, ImageFormat.Png);<br />
//Convert to byte[]<br />
OutStream.Position = 0;<br />
byte[] buffer = OutStream.ToArray();<br />


Vielleicht erspart das jemandem viel Lesearbeit.

PS. Der Original-Code war mir eine grosse Hilfe!

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.