Graphics.CopyFromScreen Método

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Executa uma transferência de bloco de bits dos dados de cores da tela até a superfície de desenho do Graphics.

Sobrecargas

CopyFromScreen(Point, Point, Size)	Executa uma transferência de bloco de bits dos dados de cores, correspondendo a um retângulo de pixels, da tela até a superfície de desenho do Graphics.
CopyFromScreen(Point, Point, Size, CopyPixelOperation)	Executa uma transferência de bloco de bits dos dados de cores, correspondendo a um retângulo de pixels, da tela até a superfície de desenho do Graphics.
CopyFromScreen(Int32, Int32, Int32, Int32, Size)	Executa uma transferência de bloco de bits dos dados de cores, correspondente a um retângulo de pixels, da tela à superfície de desenho do Graphics.
CopyFromScreen(Int32, Int32, Int32, Int32, Size, CopyPixelOperation)	Executa uma transferência de bloco de bits dos dados de cores, correspondente a um retângulo de pixels, da tela à superfície de desenho do Graphics.

CopyFromScreen(Point, Point, Size)

Origem:

Graphics.cs

Executa uma transferência de bloco de bits dos dados de cores, correspondendo a um retângulo de pixels, da tela até a superfície de desenho do 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)

Parâmetros

upperLeftSource

Point

O ponto no canto superior esquerdo do retângulo de origem.

upperLeftDestination

Point

O ponto no canto superior esquerdo do retângulo de destino.

blockRegionSize

Size

O tamanho da área a ser transferida.

Exceções

Win32Exception

Falha na operação.

Exemplos

O exemplo a seguir demonstra como usar o CopyFromScreen método . Para executar este exemplo, cole-o em um Formulário do Windows. Manipule o evento do Paint formulário e chame o CopyPixels1 método do Paint método de tratamento de eventos, passando e como 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

Comentários

Os CopyFromScreen métodos são úteis para colocar uma imagem em camadas sobre outra. Para especificar como as cores de origem e destino são combinadas, use um dos CopyFromScreen métodos que usa um CopyPixelOperation parâmetro .

Confira também

• Como: imprimir um Windows Form
• Como copiar pixels para reduzir a cintilação em Windows Forms

CopyFromScreen(Point, Point, Size, CopyPixelOperation)

Origem:

Graphics.cs

Executa uma transferência de bloco de bits dos dados de cores, correspondendo a um retângulo de pixels, da tela até a superfície de desenho do 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

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

Parâmetros

upperLeftSource

Point

O ponto no canto superior esquerdo do retângulo de origem.

upperLeftDestination

Point

O ponto no canto superior esquerdo do retângulo de destino.

blockRegionSize

Size

O tamanho da área a ser transferida.

copyPixelOperation

CopyPixelOperation

Um dos valores de CopyPixelOperation.

Exceções

InvalidEnumArgumentException

copyPixelOperation não é membro de CopyPixelOperation.

Win32Exception

Falha na operação.

Exemplos

O exemplo a seguir demonstra como usar o CopyFromScreen método . Para executar este exemplo, cole-o em um Formulário do Windows. Manipule o evento do Paint formulário e chame o CopyPixels2 método do Paint método de tratamento de eventos, passando e como 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

Comentários

Os CopyFromScreen métodos são úteis para colocar uma imagem em camadas sobre outra. O copyPixelOperation parâmetro permite especificar se e como as cores de origem devem ser combinadas com as cores na área de destino.

Confira também

• Como: imprimir um Windows Form
• Como copiar pixels para reduzir a cintilação em Windows Forms

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

Origem:

Graphics.cs

Executa uma transferência de bloco de bits dos dados de cores, correspondente a um retângulo de pixels, da tela à superfície de desenho do 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)

Parâmetros

sourceX

Int32

A coordenada X do ponto no canto superior esquerdo do retângulo de origem.

sourceY

Int32

A coordenada y do ponto no canto superior esquerdo do retângulo de origem.

destinationX

Int32

A coordenada X do ponto no canto superior esquerdo do retângulo de destino.

destinationY

Int32

A coordenada y do ponto no canto superior esquerdo do retângulo de destino.

blockRegionSize

Size

O tamanho da área a ser transferida.

Exceções

Win32Exception

Falha na operação.

Exemplos

O exemplo de código a seguir demonstra como usar o CopyFromScreen para imprimir uma cópia do formulário atual.

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

Comentários

Os CopyFromScreen métodos são úteis para colocar uma imagem em camadas sobre outra. Para especificar como as cores de origem e destino são combinadas, use um dos CopyFromScreen métodos que usa um CopyPixelOperation parâmetro .

Confira também

• Como: imprimir um Windows Form
• Como copiar pixels para reduzir a cintilação em Windows Forms

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

Origem:

Graphics.cs

Executa uma transferência de bloco de bits dos dados de cores, correspondente a um retângulo de pixels, da tela à superfície de desenho do 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

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

Parâmetros

sourceX

Int32

A coordenada X do ponto no canto superior esquerdo do retângulo de origem.

sourceY

Int32

A coordenada y do ponto no canto superior esquerdo do retângulo de origem.

destinationX

Int32

A coordenada X do ponto no canto superior esquerdo do retângulo de destino.

destinationY

Int32

A coordenada y do ponto no canto superior esquerdo do retângulo de destino.

blockRegionSize

Size

O tamanho da área a ser transferida.

copyPixelOperation

CopyPixelOperation

Um dos valores de CopyPixelOperation.

Exceções

InvalidEnumArgumentException

copyPixelOperation não é membro de CopyPixelOperation.

Win32Exception

Falha na operação.

Exemplos

O exemplo a seguir demonstra como usar o CopyFromScreen método . Para executar este exemplo, cole-o em um Formulário do Windows. Manipule o evento do Paint formulário e chame o CopyPixels4 método do Paint método de tratamento de eventos, passando e como 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

Comentários

Os CopyFromScreen métodos são úteis para colocar uma imagem em camadas sobre outra. O copyPixelOperation parâmetro permite especificar se e como as cores de origem devem ser combinadas com as cores na área de destino.

Confira também

• Como: imprimir um Windows Form
• Como copiar pixels para reduzir a cintilação em Windows Forms