Graphics.CopyFromScreen Método

Referência

Definição

Namespace:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Pacote:: System.Drawing.Common v6.0.0

Pacote:: System.Drawing.Common v7.0.0

Pacote:: System.Drawing.Common v8.0.0

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

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Origem:: Graphics.cs

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

Aplica-se a

CopyFromScreen(Point, Point, Size, CopyPixelOperation)

Origem:: Graphics.cs

Origem:: Graphics.cs

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

Aplica-se a

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

Origem:: Graphics.cs

Origem:: Graphics.cs

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

Confira também

Aplica-se a

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

Origem:: Graphics.cs

Origem:: Graphics.cs

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

Confira também

Aplica-se a

Partilhar via

Graphics.CopyFromScreen Método

Definição

Sobrecargas

CopyFromScreen(Point, Point, Size)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

CopyFromScreen(Point, Point, Size, CopyPixelOperation)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Recursos adicionais