Graphics.DrawImageUnscaled Método

Definição

Desenha a imagem especificada usando o seu tamanho físico original na localização especificada por um par de coordenadas.

Sobrecargas

Name Description
DrawImageUnscaled(Image, Int32, Int32)

Desenha a imagem especificada usando o seu tamanho físico original na localização especificada por um par de coordenadas.

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

Desenha uma imagem especificada usando o seu tamanho físico original numa localização especificada.

DrawImageUnscaled(Image, Point)

Desenha uma imagem especificada usando o seu tamanho físico original numa localização especificada.

DrawImageUnscaled(Image, Rectangle)

Desenha uma imagem especificada usando o seu tamanho físico original numa localização especificada.

DrawImageUnscaled(Image, Int32, Int32)

Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs

Desenha a imagem especificada usando o seu tamanho físico original na localização especificada 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 para desenhar.

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

image é null.

Exemplos

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

  • Cria uma imagem a partir de um ficheiro JPEG, SampImag.jpg, na pasta do exemplo.

  • Cria um ponto onde se desenha o canto superior esquerdo da imagem.

  • Desenha toda a imagem usando o 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

Observações

An armazena um valor para a largura dos Image píxeis e um valor para a resolução horizontal (pontos por polegada). A largura física, medida em polegadas, de uma imagem é a largura do píxel dividida pela resolução horizontal. Por exemplo, uma imagem com largura de píxel de 216 e resolução horizontal de 72 pontos por polegada tem uma largura física de 3 polegadas. Observações semelhantes aplicam-se à altura dos píxeis e à altura física.

O DrawImageUnscaled método desenha uma imagem usando o seu tamanho físico, pelo que a imagem terá o tamanho correto em polegadas independentemente da resolução (pontos por polegada) do dispositivo de visualização. Por exemplo, suponha que uma imagem tem uma largura de píxel de 216 e uma resolução horizontal de 72 pontos por polegada. Se pedires DrawImageUnscaled para desenhar essa imagem num dispositivo com resolução de 96 pontos por polegada, a largura do pixel da imagem renderizada será (216/72)*96 = 288.

Aplica-se a

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

Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs

Desenha uma imagem especificada usando o seu tamanho físico original numa localização especificada.

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 para desenhar.

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 utilizado.

height
Int32

Não utilizado.

Exceções

image é null.

Observações

An armazena um valor para a largura dos Image píxeis e um valor para a resolução horizontal (pontos por polegada). A largura física, medida em polegadas, de uma imagem é a largura do píxel dividida pela resolução horizontal. Por exemplo, uma imagem com largura de píxel de 216 e resolução horizontal de 72 pontos por polegada tem uma largura física de 3 polegadas. Observações semelhantes aplicam-se à altura dos píxeis e à altura física.

O DrawImageUnscaled método desenha uma imagem usando o seu tamanho físico, pelo que a imagem terá o tamanho correto em polegadas independentemente da resolução (pontos por polegada) do dispositivo de visualização. Por exemplo, suponha que uma imagem tem uma largura de píxel de 216 e uma resolução horizontal de 72 pontos por polegada. Se pedires DrawImageUnscaled para desenhar essa imagem num dispositivo com resolução de 96 pontos por polegada, a largura do pixel da imagem renderizada será (216/72)*96 = 288.

Aplica-se a

DrawImageUnscaled(Image, Point)

Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs

Desenha uma imagem especificada usando o seu tamanho físico original numa localização especificada.

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 para desenhar.

point
Point

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

Exceções

image é null.

Exemplos

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

  • Cria uma imagem a partir de um ficheiro JPEG SampImag.jpg na pasta do exemplo.

  • Cria um ponto onde se desenha o canto superior esquerdo da imagem.

  • Desenha toda a imagem usando o 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

Observações

An armazena um valor para a largura dos Image píxeis e um valor para a resolução horizontal (pontos por polegada). A largura física, medida em polegadas, de uma imagem é a largura do píxel dividida pela resolução horizontal. Por exemplo, uma imagem com largura de píxel de 216 e resolução horizontal de 72 pontos por polegada tem uma largura física de 3 polegadas. Observações semelhantes aplicam-se à altura dos píxeis e à altura física.

O DrawImageUnscaled método desenha uma imagem usando o seu tamanho físico, pelo que a imagem terá o tamanho correto em polegadas independentemente da resolução (pontos por polegada) do dispositivo de visualização. Por exemplo, suponha que uma imagem tem uma largura de píxel de 216 e uma resolução horizontal de 72 pontos por polegada. Se pedires DrawImageUnscaled para desenhar essa imagem num dispositivo com resolução de 96 pontos por polegada, a largura do pixel da imagem renderizada será (216/72)*96 = 288.

Aplica-se a

DrawImageUnscaled(Image, Rectangle)

Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs

Desenha uma imagem especificada usando o seu tamanho físico original numa localização especificada.

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 para desenhar.

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

image é null.

Observações

An armazena um valor para a largura dos Image píxeis e um valor para a resolução horizontal (pontos por polegada). A largura física, medida em polegadas, de uma imagem é a largura do píxel dividida pela resolução horizontal. Por exemplo, uma imagem com largura de píxel de 216 e resolução horizontal de 72 pontos por polegada tem uma largura física de 3 polegadas. Observações semelhantes aplicam-se à altura dos píxeis e à altura física.

O DrawImageUnscaled método desenha uma imagem usando o seu tamanho físico, pelo que a imagem terá o tamanho correto em polegadas independentemente da resolução (pontos por polegada) do dispositivo de visualização. Por exemplo, suponha que uma imagem tem uma largura de píxel de 216 e uma resolução horizontal de 72 pontos por polegada. Se pedires DrawImageUnscaled para desenhar essa imagem num dispositivo com resolução de 96 pontos por polegada, a largura do pixel da imagem renderizada será (216/72)*96 = 288.

Aplica-se a