Graphics.CopyFromScreen Méthode

Définition

Effectue le transfert de bloc de bits des données de couleur de l'écran à la surface de dessin de Graphics.Performs a bit-block transfer of color data from the screen to the drawing surface of the Graphics.

Surcharges

CopyFromScreen(Int32, Int32, Int32, Int32, Size)

Effectue le transfert de bloc de bits des données de couleur correspondant à un rectangle de pixels de l'écran à la surface de dessin de Graphics.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.

CopyFromScreen(Int32, Int32, Int32, Int32, Size, CopyPixelOperation)

Effectue le transfert de bloc de bits des données de couleur correspondant à un rectangle de pixels de l'écran à la surface de dessin de Graphics.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.

CopyFromScreen(Point, Point, Size)

Effectue le transfert de bloc de bits des données de couleur correspondant à un rectangle de pixels de l'écran à la surface de dessin de Graphics.Performs a bit-block transfer of color data, corresponding to a rectangle of pixels, from the screen to the drawing surface of the Graphics.

CopyFromScreen(Point, Point, Size, CopyPixelOperation)

Effectue le transfert de bloc de bits des données de couleur correspondant à un rectangle de pixels de l'écran à la surface de dessin de Graphics.Performs a bit-block transfer of color data, corresponding to a rectangle of pixels, from the screen to the drawing surface of the Graphics.

CopyFromScreen(Int32, Int32, Int32, Int32, Size)

Effectue le transfert de bloc de bits des données de couleur correspondant à un rectangle de pixels de l'écran à la surface de dessin de Graphics.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.

public:
 void CopyFromScreen(int sourceX, int sourceY, int destinationX, int destinationY, System::Drawing::Size blockRegionSize);
public void CopyFromScreen (int sourceX, int sourceY, int destinationX, int destinationY, System.Drawing.Size blockRegionSize);
member this.CopyFromScreen : int * int * int * int * System.Drawing.Size -> unit
Public Sub CopyFromScreen (sourceX As Integer, sourceY As Integer, destinationX As Integer, destinationY As Integer, blockRegionSize As Size)

Paramètres

sourceX
Int32

Coordonnée x du point situé dans l'angle supérieur gauche du rectangle source.The x-coordinate of the point at the upper-left corner of the source rectangle.

sourceY
Int32

Coordonnée y du point situé dans l'angle supérieur gauche du rectangle source.The y-coordinate of the point at the upper-left corner of the source rectangle.

destinationX
Int32

Coordonnée x du point situé dans l'angle supérieur gauche du rectangle de destination.The x-coordinate of the point at the upper-left corner of the destination rectangle.

destinationY
Int32

Coordonnée y du point situé dans l'angle supérieur gauche du rectangle de destination.The y-coordinate of the point at the upper-left corner of the destination rectangle.

blockRegionSize
Size

Taille de la zone à transférer.The size of the area to be transferred.

Exceptions

L'opération a échoué.The operation failed.

Exemples

L’exemple de code suivant montre comment utiliser la CopyFromScreen pour imprimer une copie du formulaire actif.The following code example demonstrates how to use the CopyFromScreen for printing a copy of the current form.


using System;
using System.Windows.Forms;
using System.Drawing;
using System.Drawing.Printing;

public class Form1 :
    Form
{
    private Button printButton = new Button();
    private PrintDocument printDocument1 = new PrintDocument();

    public Form1()
    {
        printButton.Text = "Print Form";
        printButton.Click += new EventHandler(printButton_Click);
        printDocument1.PrintPage += new PrintPageEventHandler(printDocument1_PrintPage);
        this.Controls.Add(printButton);
    }

    void printButton_Click(object sender, EventArgs e)
    {
        CaptureScreen();
        printDocument1.Print();
    }

    Bitmap memoryImage;

    private void CaptureScreen()
    {
        Graphics myGraphics = this.CreateGraphics();
        Size s = this.Size;
        memoryImage = new Bitmap(s.Width, s.Height, myGraphics);
        Graphics memoryGraphics = Graphics.FromImage(memoryImage);
        memoryGraphics.CopyFromScreen(this.Location.X, this.Location.Y, 0, 0, s);
    }

    private void printDocument1_PrintPage(System.Object sender,  
           System.Drawing.Printing.PrintPageEventArgs e)
    {
        e.Graphics.DrawImage(memoryImage, 0, 0);
    }

    public static void Main()
    {
        Application.Run(new Form1());
    }
}
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

Remarques

Les méthodes de CopyFromScreen sont utiles pour la superposition d’une image par-dessus une autre.The CopyFromScreen methods are useful for layering one image on top of another. Pour spécifier le mode de fusion des couleurs source et de destination, utilisez l’une des méthodes CopyFromScreen qui accepte un paramètre CopyPixelOperation.To specify how the source and destination colors are blended, use one of the CopyFromScreen methods that takes a CopyPixelOperation parameter.

Sécurité

UIPermission
pour accéder à toutes les fenêtres.for access to all windows. Énumération associée : AllWindows.Related enumeration: AllWindows.

Voir aussi

CopyFromScreen(Int32, Int32, Int32, Int32, Size, CopyPixelOperation)

Effectue le transfert de bloc de bits des données de couleur correspondant à un rectangle de pixels de l'écran à la surface de dessin de Graphics.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.

public:
 void CopyFromScreen(int sourceX, int sourceY, int destinationX, int destinationY, System::Drawing::Size blockRegionSize, System::Drawing::CopyPixelOperation copyPixelOperation);
public void CopyFromScreen (int sourceX, int sourceY, int destinationX, int destinationY, System.Drawing.Size blockRegionSize, System.Drawing.CopyPixelOperation copyPixelOperation);
member this.CopyFromScreen : int * int * int * int * System.Drawing.Size * System.Drawing.CopyPixelOperation -> unit

Paramètres

sourceX
Int32

Coordonnée x du point situé dans l'angle supérieur gauche du rectangle source.The x-coordinate of the point at the upper-left corner of the source rectangle.

sourceY
Int32

Coordonnée y du point situé dans l'angle supérieur gauche du rectangle source.The y-coordinate of the point at the upper-left corner of the source rectangle

destinationX
Int32

Coordonnée x du point situé dans l'angle supérieur gauche du rectangle de destination.The x-coordinate of the point at the upper-left corner of the destination rectangle.

destinationY
Int32

Coordonnée y du point situé dans l'angle supérieur gauche du rectangle de destination.The y-coordinate of the point at the upper-left corner of the destination rectangle.

blockRegionSize
Size

Taille de la zone à transférer.The size of the area to be transferred.

copyPixelOperation
CopyPixelOperation

Une des valeurs de l'objet CopyPixelOperation.One of the CopyPixelOperation values.

Exceptions

copyPixelOperation n’est pas membre de CopyPixelOperationcopyPixelOperation is not a member of CopyPixelOperation.

L'opération a échoué.The operation failed.

Exemples

L'exemple suivant décrit comment utiliser la méthode CopyFromScreen.The following example demonstrates how to use the CopyFromScreen method. Pour exécuter cet exemple, collez-le dans un Windows Form.To run this example, paste it into a Windows Form. Gérez l’événement Paint du formulaire et appelez la méthode CopyPixels4 à partir de la méthode de gestion des événements Paint, en passant e comme PaintEventArgs.Handle the form's Paint event and call the CopyPixels4 method from the Paint event-handling method, passing e as PaintEventArgs.

private void CopyPixels4(PaintEventArgs e)
{
    e.Graphics.CopyFromScreen(0, 0, 20, 20, new Size(160, 160), 
        CopyPixelOperation.SourceInvert);
}
Private Sub CopyPixels4(ByVal e As PaintEventArgs) 
    e.Graphics.CopyFromScreen(0, 0, 20, 20, _
        New Size(160, 160), CopyPixelOperation.SourceInvert)
End Sub

Remarques

Les méthodes de CopyFromScreen sont utiles pour la superposition d’une image par-dessus une autre.The CopyFromScreen methods are useful for layering one image on top of another. Le paramètre copyPixelOperation vous permet de spécifier si et comment les couleurs sources doivent être fusionnées avec les couleurs de la zone de destination.The copyPixelOperation parameter allows you to specify if and how the source colors should be blended with the colors in the destination area.

Sécurité

UIPermission
pour accéder à toutes les fenêtres.for access to all windows. Énumération associée : AllWindows.Related enumeration: AllWindows.

Voir aussi

CopyFromScreen(Point, Point, Size)

Effectue le transfert de bloc de bits des données de couleur correspondant à un rectangle de pixels de l'écran à la surface de dessin de Graphics.Performs a bit-block transfer of color data, corresponding to a rectangle of pixels, from the screen to the drawing surface of the Graphics.

public:
 void CopyFromScreen(System::Drawing::Point upperLeftSource, System::Drawing::Point upperLeftDestination, System::Drawing::Size blockRegionSize);
public void CopyFromScreen (System.Drawing.Point upperLeftSource, System.Drawing.Point upperLeftDestination, System.Drawing.Size blockRegionSize);
member this.CopyFromScreen : System.Drawing.Point * System.Drawing.Point * System.Drawing.Size -> unit
Public Sub CopyFromScreen (upperLeftSource As Point, upperLeftDestination As Point, blockRegionSize As Size)

Paramètres

upperLeftSource
Point

Point situé dans l'angle supérieur gauche du rectangle source.The point at the upper-left corner of the source rectangle.

upperLeftDestination
Point

Point situé dans l'angle supérieur gauche du rectangle de destination.The point at the upper-left corner of the destination rectangle.

blockRegionSize
Size

Taille de la zone à transférer.The size of the area to be transferred.

Exceptions

L'opération a échoué.The operation failed.

Exemples

L'exemple suivant décrit comment utiliser la méthode CopyFromScreen.The following example demonstrates how to use the CopyFromScreen method. Pour exécuter cet exemple, collez-le dans un Windows Form.To run this example, paste it into a Windows Form. Gérez l’événement Paint du formulaire et appelez la méthode CopyPixels1 à partir de la méthode de gestion des événements Paint, en passant e comme PaintEventArgs.Handle the form's Paint event and call the CopyPixels1 method from the Paint event-handling method, passing e as PaintEventArgs.

private void CopyPixels1(PaintEventArgs e)
{
    e.Graphics.CopyFromScreen(this.Location, 
        new Point(40, 40), new Size(100, 100));
}
Private Sub CopyPixels1(ByVal e As PaintEventArgs) 
    e.Graphics.CopyFromScreen(Me.Location, _
        New Point(40, 40), New Size(100, 100))

End Sub

Remarques

Les méthodes de CopyFromScreen sont utiles pour la superposition d’une image par-dessus une autre.The CopyFromScreen methods are useful for layering one image on top of another. Pour spécifier le mode de fusion des couleurs source et de destination, utilisez l’une des méthodes CopyFromScreen qui accepte un paramètre CopyPixelOperation.To specify how the source and destination colors are blended, use one of the CopyFromScreen methods that takes a CopyPixelOperation parameter.

Sécurité

UIPermission
pour accéder à toutes les fenêtres.for access to all windows. Énumération associée : AllWindows.Related enumeration: AllWindows.

Voir aussi

CopyFromScreen(Point, Point, Size, CopyPixelOperation)

Effectue le transfert de bloc de bits des données de couleur correspondant à un rectangle de pixels de l'écran à la surface de dessin de Graphics.Performs a bit-block transfer of color data, corresponding to a rectangle of pixels, from the screen to the drawing surface of the Graphics.

public:
 void CopyFromScreen(System::Drawing::Point upperLeftSource, System::Drawing::Point upperLeftDestination, System::Drawing::Size blockRegionSize, System::Drawing::CopyPixelOperation copyPixelOperation);
public void CopyFromScreen (System.Drawing.Point upperLeftSource, System.Drawing.Point upperLeftDestination, System.Drawing.Size blockRegionSize, System.Drawing.CopyPixelOperation copyPixelOperation);
member this.CopyFromScreen : System.Drawing.Point * System.Drawing.Point * System.Drawing.Size * System.Drawing.CopyPixelOperation -> unit

Paramètres

upperLeftSource
Point

Point situé dans l'angle supérieur gauche du rectangle source.The point at the upper-left corner of the source rectangle.

upperLeftDestination
Point

Point situé dans l'angle supérieur gauche du rectangle de destination.The point at the upper-left corner of the destination rectangle.

blockRegionSize
Size

Taille de la zone à transférer.The size of the area to be transferred.

copyPixelOperation
CopyPixelOperation

Une des valeurs de l'objet CopyPixelOperation.One of the CopyPixelOperation values.

Exceptions

copyPixelOperation n’est pas membre de CopyPixelOperationcopyPixelOperation is not a member of CopyPixelOperation.

L'opération a échoué.The operation failed.

Exemples

L'exemple suivant décrit comment utiliser la méthode CopyFromScreen.The following example demonstrates how to use the CopyFromScreen method. Pour exécuter cet exemple, collez-le dans un Windows Form.To run this example, paste it into a Windows Form. Gérez l’événement Paint du formulaire et appelez la méthode CopyPixels2 à partir de la méthode de gestion des événements Paint, en passant e comme PaintEventArgs.Handle the form's Paint event and call the CopyPixels2 method from the Paint event-handling method, passing e as PaintEventArgs.

private void CopyPixels2(PaintEventArgs e)
{
    e.Graphics.CopyFromScreen(this.Location, new Point(40, 40), 
        new Size(100, 100), CopyPixelOperation.MergePaint); 
}
Private Sub CopyPixels2(ByVal e As PaintEventArgs) 
    e.Graphics.CopyFromScreen(Me.Location, _
        New Point(40, 40), New Size(100, 100), _
        CopyPixelOperation.MergePaint)
End Sub

Remarques

Les méthodes de CopyFromScreen sont utiles pour la superposition d’une image par-dessus une autre.The CopyFromScreen methods are useful for layering one image on top of another. Le paramètre copyPixelOperation vous permet de spécifier si et comment les couleurs sources doivent être fusionnées avec les couleurs de la zone de destination.The copyPixelOperation parameter allows you to specify if and how the source colors should be blended with the colors in the destination area.

Sécurité

UIPermission
pour accéder à toutes les fenêtres.for access to all windows. Énumération associée : AllWindows.Related enumeration: AllWindows.

Voir aussi

S’applique à