Graphics.CopyFromScreen Methode

Referenz

Definition

Namespace:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Paket:: System.Drawing.Common v6.0.0

Paket:: System.Drawing.Common v7.0.0

Paket:: System.Drawing.Common v8.0.0

Paket:: System.Drawing.Common v9.0.0-preview.2.24128.3

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Führt einen Bitblocktransfer der Farbdaten vom Bildschirm auf die Zeichenoberfläche des Graphics aus.

Überlädt

CopyFromScreen(Point, Point, Size)	Führt entsprechend einem Rechteck aus Pixeln einen Bitblocktransfer der Farbdaten vom Bildschirm auf die Zeichenoberfläche des Graphics aus.
CopyFromScreen(Point, Point, Size, CopyPixelOperation)	Führt entsprechend einem Rechteck aus Pixeln einen Bitblocktransfer der Farbdaten vom Bildschirm auf die Zeichenoberfläche des Graphics aus.
CopyFromScreen(Int32, Int32, Int32, Int32, Size)	Führt entsprechend einem Rechteck aus Pixeln einen Bitblocktransfer der Farbdaten vom Bildschirm auf die Zeichenoberfläche des Graphics aus.
CopyFromScreen(Int32, Int32, Int32, Int32, Size, CopyPixelOperation)	Führt entsprechend einem Rechteck aus Pixeln einen Bitblocktransfer der Farbdaten vom Bildschirm auf die Zeichenoberfläche des Graphics aus.

CopyFromScreen(Point, Point, Size)

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Führt entsprechend einem Rechteck aus Pixeln einen Bitblocktransfer der Farbdaten vom Bildschirm auf die Zeichenoberfläche des Graphics aus.

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)

Parameter

upperLeftSource: Point

Der Punkt in der linken oberen Ecke des Quellrechtecks.

upperLeftDestination: Point

Der Punkt in der linken oberen Ecke des Zielrechtecks.

blockRegionSize: Size

Die Größe des Bereichs, der übertragen werden soll.

Ausnahmen

Win32Exception

Fehler beim Vorgang.

Beispiele

Im folgenden Beispiel wird die Verwendung der CopyFromScreen-Methode veranschaulicht. Um dieses Beispiel auszuführen, fügen Sie es in ein Windows Form-Formular ein. Behandeln Sie das Ereignis des Formulars Paint , und rufen Sie die CopyPixels1 -Methode von der Paint Ereignisbehandlungsmethode auf, und übergeben Sie e als 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

Hinweise

Die CopyFromScreen Methoden sind nützlich, um ein Bild über einem anderen zu schichten. Um anzugeben, wie die Quell- und Zielfarben gemischt werden, verwenden Sie eine der Methoden, die CopyFromScreen einen CopyPixelOperation Parameter akzeptiert.

Weitere Informationen

Gilt für:

CopyFromScreen(Point, Point, Size, CopyPixelOperation)

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Führt entsprechend einem Rechteck aus Pixeln einen Bitblocktransfer der Farbdaten vom Bildschirm auf die Zeichenoberfläche des Graphics aus.

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

Public Sub CopyFromScreen (upperLeftSource As Point, upperLeftDestination As Point, blockRegionSize As Size, copyPixelOperation As CopyPixelOperation)

Parameter

upperLeftSource: Point

Der Punkt in der linken oberen Ecke des Quellrechtecks.

upperLeftDestination: Point

Der Punkt in der linken oberen Ecke des Zielrechtecks.

blockRegionSize: Size

Die Größe des Bereichs, der übertragen werden soll.

copyPixelOperation: CopyPixelOperation

Einer der CopyPixelOperation-Werte.

Ausnahmen

InvalidEnumArgumentException

copyPixelOperation ist kein Member von CopyPixelOperation.

Win32Exception

Fehler beim Vorgang.

Beispiele

Im folgenden Beispiel wird die Verwendung der CopyFromScreen-Methode veranschaulicht. Um dieses Beispiel auszuführen, fügen Sie es in ein Windows Form-Formular ein. Behandeln Sie das Ereignis des Formulars Paint , und rufen Sie die CopyPixels2 -Methode von der Paint Ereignisbehandlungsmethode auf, und übergeben Sie e als 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

Hinweise

Die CopyFromScreen Methoden sind nützlich, um ein Bild über einem anderen zu schichten. Mit copyPixelOperation dem Parameter können Sie angeben, ob und wie die Quellfarben mit den Farben im Zielbereich gemischt werden sollen.

Weitere Informationen

Gilt für:

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

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Führt entsprechend einem Rechteck aus Pixeln einen Bitblocktransfer der Farbdaten vom Bildschirm auf die Zeichenoberfläche des Graphics aus.

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)

Parameter

sourceX: Int32

Die x-Koordinate des Punktes in der linken oberen Ecke des Quellrechtecks.

sourceY: Int32

Die y-Koordinate des Punktes in der linken oberen Ecke des Quellrechtecks.

destinationX: Int32

Die x-Koordinate des Punktes in der linken oberen Ecke des Zielrechtecks.

destinationY: Int32

Die y-Koordinate des Punktes in der linken oberen Ecke des Zielrechtecks.

blockRegionSize: Size

Die Größe des Bereichs, der übertragen werden soll.

Ausnahmen

Win32Exception

Fehler beim Vorgang.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie eine CopyFromScreen Kopie des aktuellen Formulars drucken.

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

Hinweise

Weitere Informationen

Gilt für:

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

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Führt entsprechend einem Rechteck aus Pixeln einen Bitblocktransfer der Farbdaten vom Bildschirm auf die Zeichenoberfläche des Graphics aus.

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

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

Parameter

sourceX: Int32

Die x-Koordinate des Punktes in der linken oberen Ecke des Quellrechtecks.

sourceY: Int32

Die y-Koordinate des Punktes in der linken oberen Ecke des Quellrechtecks.

destinationX: Int32

Die x-Koordinate des Punktes in der linken oberen Ecke des Zielrechtecks.

destinationY: Int32

Die y-Koordinate des Punktes in der linken oberen Ecke des Zielrechtecks.

blockRegionSize: Size

Die Größe des Bereichs, der übertragen werden soll.

copyPixelOperation: CopyPixelOperation

Einer der CopyPixelOperation-Werte.

Ausnahmen

InvalidEnumArgumentException

copyPixelOperation ist kein Member von CopyPixelOperation.

Win32Exception

Fehler beim Vorgang.

Beispiele

Im folgenden Beispiel wird die Verwendung der CopyFromScreen-Methode veranschaulicht. Um dieses Beispiel auszuführen, fügen Sie es in ein Windows Form-Formular ein. Behandeln Sie das Ereignis des Formulars Paint , und rufen Sie die CopyPixels4 -Methode von der Paint Ereignisbehandlungsmethode auf, und übergeben Sie e als 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

Hinweise

Weitere Informationen

Gilt für:

Freigeben über

Graphics.CopyFromScreen Methode

Definition

Überlädt

CopyFromScreen(Point, Point, Size)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

CopyFromScreen(Point, Point, Size, CopyPixelOperation)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

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

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

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

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen