Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método Graphics.DrawImage (Image, RectangleF, RectangleF, GraphicsUnit)

 
System_CAPS_noteObservação

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

Desenha a parte especificada do Image especificado no local especificado e com o tamanho especificado.

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

public void DrawImage(
	Image image,
	RectangleF destRect,
	RectangleF srcRect,
	GraphicsUnit srcUnit
)

Parâmetros

image
Type: System.Drawing.Image

Image a ser desenhado.

destRect
Type: System.Drawing.RectangleF

A estrutura RectangleF que especifica o local e o tamanho da imagem desenhada. A imagem é dimensionada para se ajustar ao retângulo.

srcRect
Type: System.Drawing.RectangleF

A estrutura RectangleF que especifica a parte do objeto image a ser desenhada.

srcUnit
Type: System.Drawing.GraphicsUnit

Membro da enumeração de GraphicsUnit que especifica as unidades de medida usadas pelo parâmetro srcRect.

Exception Condition
ArgumentNullException

image é null.

O srcRect parâmetro especifica uma parte retangular do image objeto ao desenhar. Esta parte é dimensionada para caber dentro do retângulo especificado pelo destRect parâmetro.

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. O código executa as seguintes ações:

  • Cria uma imagem de um arquivo JPEG SampImag.jpg na pasta do exemplo.

  • Cria um retângulo de destino no qual desenhar a imagem.

  • Cria um retângulo de origem do qual extrair uma parte da imagem.

  • Define a unidade de medida do retângulo de origem em pixels.

  • Desenha a imagem para a tela.

A posição do retângulo de destino localiza a imagem na tela, os tamanhos dos retângulos de origem e destino determinam o dimensionamento da imagem emitida e o tamanho do retângulo de origem determina qual parte da imagem original é desenhada para o tela.

public void DrawImageRectFRectF(PaintEventArgs e)
{

    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");

    // Create rectangle for displaying image.
    RectangleF destRect = new RectangleF(100.0F, 100.0F, 450.0F, 150.0F);

    // Create rectangle for source image.
    RectangleF srcRect = new RectangleF(50.0F, 50.0F, 150.0F, 150.0F);
    GraphicsUnit units = GraphicsUnit.Pixel;

    // Draw image to screen.
    e.Graphics.DrawImage(newImage, destRect, srcRect, units);
}

.NET Framework
Disponível desde 1.1
Retornar ao início
Mostrar: