Graphics.DrawImageUnscaled Método

Referência

Definição

Namespace:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Pacote:: System.Drawing.Common v8.0.8

Pacote:: System.Drawing.Common v9.0.0-rc.1.24451.1

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.

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

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

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

ArgumentNullException

image é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. 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 a imagem inteira 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 método DrawImageUnscaled desenha uma imagem usando seu tamanho físico, portanto, 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 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.

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

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

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

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

height: Int32

Não usado.

Exceções

ArgumentNullException

image é null.

Comentários

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

DrawImageUnscaled(Image, Point)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

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

point: Point

Point estrutura 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 o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. 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 a imagem inteira 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

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

DrawImageUnscaled(Image, Rectangle)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

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 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 Width e Height são ignoradas.

Exceções

ArgumentNullException

image é null.

Comentários

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Partilhar via

Graphics.DrawImageUnscaled Método

Definição

Sobrecargas

DrawImageUnscaled(Image, Int32, Int32)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

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

Parâmetros

Exceções

Comentários

Aplica-se a

DrawImageUnscaled(Image, Point)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

DrawImageUnscaled(Image, Rectangle)

Parâmetros

Exceções

Comentários

Aplica-se a

Recursos adicionais