Graphics.DrawImageUnscaled Método

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Desenha a imagem especificada usando seu tamanho físico original no local especificado por um par de coordenadas.

Sobrecargas

DrawImageUnscaled(Image, Int32, Int32)	Desenha a imagem especificada usando seu tamanho físico original no local especificado por um par de coordenadas.
DrawImageUnscaled(Image, Int32, Int32, Int32, Int32)	Desenha uma imagem especificada usando seu tamanho físico original em um local especificado.
DrawImageUnscaled(Image, Point)	Desenha uma imagem especificada usando seu tamanho físico original em um local especificado.
DrawImageUnscaled(Image, Rectangle)	Desenha uma imagem especificada usando seu tamanho físico original em um local especificado.

DrawImageUnscaled(Image, Int32, Int32)

Origem:

Graphics.cs

Desenha a imagem especificada usando seu tamanho físico original no local especificado por um par de coordenadas.

public:
 void DrawImageUnscaled(System::Drawing::Image ^ image, int x, int y);

public void DrawImageUnscaled (System.Drawing.Image image, int x, int y);

member this.DrawImageUnscaled : System.Drawing.Image * int * int -> unit

Public Sub DrawImageUnscaled (image As Image, x As Integer, y As Integer)

Parâmetros

image

Image

Image a ser desenhado.

x

Int32

A coordenada X do canto superior esquerdo da imagem desenhada.

y

Int32

A coordenada y do canto superior esquerdo da imagem desenhada.

Exceções

ArgumentNullException

image é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com 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 ponto no qual desenhar o canto superior esquerdo da imagem.

• Desenha toda a imagem usando seu tamanho físico.

public:
   void DrawImageUnscaledInt( PaintEventArgs^ e )
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create coordinates for upper-left corner of image.
      int x = 100;
      int y = 100;

      // Draw image to screen.
      e->Graphics->DrawImageUnscaled( newImage, x, y );
   }

public void DrawImageUnscaledInt(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create coordinates for upper-left corner of image.
    int x = 100;
    int y = 100;
             
    // Draw image to screen.
    e.Graphics.DrawImageUnscaled(newImage, x, y);
}

Public Sub DrawImageUnscaledInt(ByVal e As PaintEventArgs)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create coordinates for upper-left corner of image.
    Dim x As Integer = 100
    Dim y As Integer = 100

    ' Draw image to screen.
    e.Graphics.DrawImageUnscaled(newImage, x, y)
End Sub

Comentários

Um Image armazena um valor para largura de pixel e um valor para resolução horizontal (pontos por polegada). A largura física, medida em polegadas, de uma imagem é a largura do pixel dividida pela resolução horizontal. Por exemplo, uma imagem com uma largura de pixel de 216 e uma resolução horizontal de 72 pontos por polegada tem uma largura física de 3 polegadas. Comentários semelhantes se aplicam à altura do pixel e à altura física.

O DrawImageUnscaled método desenha uma imagem usando seu tamanho físico, de modo que a imagem terá seu tamanho correto em polegadas, independentemente da resolução (pontos por polegada) do dispositivo de exibição. Por exemplo, suponha que uma imagem tenha uma largura de pixel de 216 e uma resolução horizontal de 72 pontos por polegada. Se você chamar DrawImageUnscaled para desenhar essa imagem em um dispositivo que tenha uma resolução de 96 pontos por polegada, a largura do pixel da imagem renderizada será (216/72)*96 = 288.

DrawImageUnscaled(Image, Int32, Int32, Int32, Int32)

Origem:

Graphics.cs

Desenha uma imagem especificada usando seu tamanho físico original em um local especificado.

public:
 void DrawImageUnscaled(System::Drawing::Image ^ image, int x, int y, int width, int height);

public void DrawImageUnscaled (System.Drawing.Image image, int x, int y, int width, int height);

member this.DrawImageUnscaled : System.Drawing.Image * int * int * int * int -> unit

Public Sub DrawImageUnscaled (image As Image, x As Integer, y As Integer, width As Integer, height As Integer)

Parâmetros

image

Image

Image a ser desenhado.

x

Int32

A coordenada X do canto superior esquerdo da imagem desenhada.

y

Int32

A coordenada y do canto superior esquerdo da imagem desenhada.

width

Int32

Não usado.

height

Int32

Não usado.

Exceções

ArgumentNullException

image é null.

Comentários

Um Image armazena um valor para largura de pixel e um valor para resolução horizontal (pontos por polegada). A largura física, medida em polegadas, de uma imagem é a largura do pixel dividida pela resolução horizontal. Por exemplo, uma imagem com uma largura de pixel de 216 e uma resolução horizontal de 72 pontos por polegada tem uma largura física de 3 polegadas. Comentários semelhantes se aplicam à altura do pixel e à altura física.

O DrawImageUnscaled método desenha uma imagem usando seu tamanho físico, de modo que a imagem terá seu tamanho correto em polegadas, independentemente da resolução (pontos por polegada) do dispositivo de exibição. Por exemplo, suponha que uma imagem tenha uma largura de pixel de 216 e uma resolução horizontal de 72 pontos por polegada. Se você chamar DrawImageUnscaled para desenhar essa imagem em um dispositivo que tenha uma resolução de 96 pontos por polegada, a largura do pixel da imagem renderizada será (216/72)*96 = 288.

DrawImageUnscaled(Image, Point)

Origem:

Graphics.cs

Desenha uma imagem especificada usando seu tamanho físico original em um local especificado.

public:
 void DrawImageUnscaled(System::Drawing::Image ^ image, System::Drawing::Point point);

public void DrawImageUnscaled (System.Drawing.Image image, System.Drawing.Point point);

member this.DrawImageUnscaled : System.Drawing.Image * System.Drawing.Point -> unit

Public Sub DrawImageUnscaled (image As Image, point As Point)

Parâmetros

image

Image

Image a ser desenhado.

point

Point

Estrutura Point que especifica o canto superior esquerdo da imagem desenhada.

Exceções

ArgumentNullException

image é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com 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 ponto no qual desenhar o canto superior esquerdo da imagem.

• Desenha toda a imagem usando seu tamanho físico.

public:
   void DrawImageUnscaledPoint( PaintEventArgs^ e )
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create point for upper-left corner of image.
      Point ulCorner = Point(100,100);

      // Draw image to screen.
      e->Graphics->DrawImageUnscaled( newImage, ulCorner );
   }

public void DrawImageUnscaledPoint(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create point for upper-left corner of image.
    Point ulCorner = new Point(100, 100);
             
    // Draw image to screen.
    e.Graphics.DrawImageUnscaled(newImage, ulCorner);
}

Public Sub DrawImageUnscaledPoint(ByVal e As PaintEventArgs)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create point for upper-left corner of image.
    Dim ulCorner As New Point(100, 100)

    ' Draw image to screen.
    e.Graphics.DrawImageUnscaled(newImage, ulCorner)
End Sub

Comentários

Um Image armazena um valor para largura de pixel e um valor para resolução horizontal (pontos por polegada). A largura física, medida em polegadas, de uma imagem é a largura do pixel dividida pela resolução horizontal. Por exemplo, uma imagem com uma largura de pixel de 216 e uma resolução horizontal de 72 pontos por polegada tem uma largura física de 3 polegadas. Comentários semelhantes se aplicam à altura do pixel e à altura física.

O DrawImageUnscaled método desenha uma imagem usando seu tamanho físico, de modo que a imagem terá seu tamanho correto em polegadas, independentemente da resolução (pontos por polegada) do dispositivo de exibição. Por exemplo, suponha que uma imagem tenha uma largura de pixel de 216 e uma resolução horizontal de 72 pontos por polegada. Se você chamar DrawImageUnscaled para desenhar essa imagem em um dispositivo que tenha uma resolução de 96 pontos por polegada, a largura do pixel da imagem renderizada será (216/72)*96 = 288.

DrawImageUnscaled(Image, Rectangle)

Origem:

Graphics.cs

Desenha uma imagem especificada usando seu tamanho físico original em um local especificado.

public:
 void DrawImageUnscaled(System::Drawing::Image ^ image, System::Drawing::Rectangle rect);

public void DrawImageUnscaled (System.Drawing.Image image, System.Drawing.Rectangle rect);

member this.DrawImageUnscaled : System.Drawing.Image * System.Drawing.Rectangle -> unit

Public Sub DrawImageUnscaled (image As Image, rect As Rectangle)

Parâmetros

image

Image

Image a ser desenhado.

rect

Rectangle

Rectangle que especifica o canto superior esquerdo da imagem desenhada. As propriedades X e Y do retângulo especificam o canto superior esquerdo. As propriedades de Largura e Altura são ignoradas.

Exceções

ArgumentNullException

image é null.

Comentários

Um Image armazena um valor para largura de pixel e um valor para resolução horizontal (pontos por polegada). A largura física, medida em polegadas, de uma imagem é a largura do pixel dividida pela resolução horizontal. Por exemplo, uma imagem com uma largura de pixel de 216 e uma resolução horizontal de 72 pontos por polegada tem uma largura física de 3 polegadas. Comentários semelhantes se aplicam à altura do pixel e à altura física.

O DrawImageUnscaled método desenha uma imagem usando seu tamanho físico, de modo que a imagem terá seu tamanho correto em polegadas, independentemente da resolução (pontos por polegada) do dispositivo de exibição. Por exemplo, suponha que uma imagem tenha uma largura de pixel de 216 e uma resolução horizontal de 72 pontos por polegada. Se você chamar DrawImageUnscaled para desenhar essa imagem em um dispositivo que tenha uma resolução de 96 pontos por polegada, a largura do pixel da imagem renderizada será (216/72)*96 = 288.