Graphics.CopyFromScreen Method (Int32, Int32, Int32, Int32, Size)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Performs a bit-block transfer of the color data, corresponding to a rectangle of pixels, from the screen to the drawing surface of the Graphics.

Namespace:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

Public Sub CopyFromScreen (
	sourceX As Integer,
	sourceY As Integer,
	destinationX As Integer,
	destinationY As Integer,
	blockRegionSize As Size
)

Parameters

sourceX
Type: System.Int32

The x-coordinate of the point at the upper-left corner of the source rectangle.

sourceY
Type: System.Int32

The y-coordinate of the point at the upper-left corner of the source rectangle.

destinationX
Type: System.Int32

The x-coordinate of the point at the upper-left corner of the destination rectangle.

destinationY
Type: System.Int32

The y-coordinate of the point at the upper-left corner of the destination rectangle.

blockRegionSize
Type: System.Drawing.Size

The size of the area to be transferred.

Exception Condition
Win32Exception

The operation failed.

The CopyFromScreen methods are useful for layering one image on top of another. To specify how the source and destination colors are blended, use one of the CopyFromScreen methods that takes a CopyPixelOperation parameter.

The following code example demonstrates how to use the CopyFromScreen for printing a copy of the current form.

Imports System
Imports System.Windows.Forms
Imports System.Drawing
Imports System.Drawing.Printing

Public Class Form1
    Inherits Form
    Private WithEvents printButton As New Button
    Private WithEvents printDocument1 As New PrintDocument

    Public Sub New()
        printButton.Text = "Print Form"
        Me.Controls.Add(printButton)
    End Sub

    Dim memoryImage As Bitmap

    Private Sub CaptureScreen()
        Dim myGraphics As Graphics = Me.CreateGraphics()
        Dim s As Size = Me.Size
        memoryImage = New Bitmap(s.Width, s.Height, myGraphics)
        Dim memoryGraphics As Graphics = Graphics.FromImage(memoryImage)
        memoryGraphics.CopyFromScreen(Me.Location.X, Me.Location.Y, 0, 0, s)
    End Sub

    Private Sub printDocument1_PrintPage(ByVal sender As System.Object, _
       ByVal e As System.Drawing.Printing.PrintPageEventArgs) Handles _
       printDocument1.PrintPage
        e.Graphics.DrawImage(memoryImage, 0, 0)
    End Sub

    Private Sub printButton_Click(ByVal sender As System.Object, ByVal e As _
       System.EventArgs) Handles printButton.Click
        CaptureScreen()
        printDocument1.Print()
    End Sub

    Public Shared Sub Main()
        Application.Run(New Form1())
    End Sub
End Class

UIPermission

for access to all windows. Related enumeration: AllWindows.

.NET Framework
Available since 2.0
Return to top
Show: