Graphics.DrawImageUnscaled Método

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v8.0.0

Dibuja la imagen especificada con su tamaño físico original y en la ubicación especificada por un par de coordenadas.

Sobrecargas

DrawImageUnscaled(Image, Int32, Int32)	Dibuja la imagen especificada con su tamaño físico original y en la ubicación especificada por un par de coordenadas.
DrawImageUnscaled(Image, Int32, Int32, Int32, Int32)	Dibuja la imagen especificada con su tamaño físico original y en la ubicación especificada.
DrawImageUnscaled(Image, Point)	Dibuja la imagen especificada con su tamaño físico original y en la ubicación especificada.
DrawImageUnscaled(Image, Rectangle)	Dibuja la imagen especificada con su tamaño físico original y en la ubicación especificada.

DrawImageUnscaled(Image, Int32, Int32)

Source:

Graphics.cs

Dibuja la imagen especificada con su tamaño físico original y en la ubicación especificada por un 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 que se va a dibujar.

x

Int32

Coordenada x de la esquina superior izquierda de la imagen dibujada.

y

Int32

Coordenada y de la esquina superior izquierda de la imagen dibujada.

Excepciones

ArgumentNullException

image es null.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del Paint controlador de eventos. El código realiza las siguientes acciones:

• Crea una imagen a partir de un archivo JPEG, SampImag.jpg, en la carpeta del ejemplo.

• Crea un punto en el que se dibuja la esquina superior izquierda de la imagen.

• Dibuja toda la imagen con su tamaño 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

Comentarios

Image almacena un valor para el ancho de píxel y un valor para la resolución horizontal (puntos por pulgada). El ancho físico, medido en pulgadas, de una imagen es el ancho de píxel dividido por la resolución horizontal. Por ejemplo, una imagen con un ancho de píxel de 216 y una resolución horizontal de 72 puntos por pulgada tiene un ancho físico de 3 pulgadas. Los comentarios similares se aplican al alto de píxeles y al alto físico.

El DrawImageUnscaled método dibuja una imagen con su tamaño físico, por lo que la imagen tendrá su tamaño correcto en pulgadas, independientemente de la resolución (puntos por pulgada) del dispositivo de pantalla. Por ejemplo, supongamos que una imagen tiene un ancho de píxel de 216 y una resolución horizontal de 72 puntos por pulgada. Si llamas DrawImageUnscaled a para dibujar esa imagen en un dispositivo que tenga una resolución de 96 puntos por pulgada, el ancho de píxel de la imagen representada será (216/72)*96 = 288.

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

Source:

Graphics.cs

Dibuja la imagen especificada con su tamaño físico original y en la ubicación 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 que se va a dibujar.

x

Int32

Coordenada x de la esquina superior izquierda de la imagen dibujada.

y

Int32

Coordenada y de la esquina superior izquierda de la imagen dibujada.

width

Int32

No se utiliza.

height

Int32

No se utiliza.

Excepciones

ArgumentNullException

image es null.

Comentarios

Image almacena un valor para el ancho de píxel y un valor para la resolución horizontal (puntos por pulgada). El ancho físico, medido en pulgadas, de una imagen es el ancho de píxel dividido por la resolución horizontal. Por ejemplo, una imagen con un ancho de píxel de 216 y una resolución horizontal de 72 puntos por pulgada tiene un ancho físico de 3 pulgadas. Los comentarios similares se aplican al alto de píxeles y al alto físico.

El DrawImageUnscaled método dibuja una imagen con su tamaño físico, por lo que la imagen tendrá su tamaño correcto en pulgadas, independientemente de la resolución (puntos por pulgada) del dispositivo de pantalla. Por ejemplo, supongamos que una imagen tiene un ancho de píxel de 216 y una resolución horizontal de 72 puntos por pulgada. Si llamas DrawImageUnscaled a para dibujar esa imagen en un dispositivo que tenga una resolución de 96 puntos por pulgada, el ancho de píxel de la imagen representada será (216/72)*96 = 288.

DrawImageUnscaled(Image, Point)

Source:

Graphics.cs

Dibuja la imagen especificada con su tamaño físico original y en la ubicación 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 que se va a dibujar.

point

Point

Estructura Point que especifica la esquina superior izquierda de la imagen dibujada.

Excepciones

ArgumentNullException

image es null.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del Paint controlador de eventos. El código realiza las siguientes acciones:

• Crea una imagen a partir de un archivo JPEG SampImag.jpg en la carpeta del ejemplo.

• Crea un punto en el que se dibuja la esquina superior izquierda de la imagen.

• Dibuja toda la imagen con su tamaño 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

Comentarios

Image almacena un valor para el ancho de píxel y un valor para la resolución horizontal (puntos por pulgada). El ancho físico, medido en pulgadas, de una imagen es el ancho de píxel dividido por la resolución horizontal. Por ejemplo, una imagen con un ancho de píxel de 216 y una resolución horizontal de 72 puntos por pulgada tiene un ancho físico de 3 pulgadas. Los comentarios similares se aplican al alto de píxeles y al alto físico.

El DrawImageUnscaled método dibuja una imagen con su tamaño físico, por lo que la imagen tendrá su tamaño correcto en pulgadas, independientemente de la resolución (puntos por pulgada) del dispositivo de pantalla. Por ejemplo, supongamos que una imagen tiene un ancho de píxel de 216 y una resolución horizontal de 72 puntos por pulgada. Si llamas DrawImageUnscaled a para dibujar esa imagen en un dispositivo que tenga una resolución de 96 puntos por pulgada, el ancho de píxel de la imagen representada será (216/72)*96 = 288.

DrawImageUnscaled(Image, Rectangle)

Source:

Graphics.cs

Dibuja la imagen especificada con su tamaño físico original y en la ubicación 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 que se va a dibujar.

rect

Rectangle

Rectangle que especifica la esquina superior izquierda de la imagen dibujada. Las propiedades X e Y del rectángulo especifican la esquina superior izquierda. Se omiten las propiedades Width y Height.

Excepciones

ArgumentNullException

image es null.

Comentarios

Image almacena un valor para el ancho de píxel y un valor para la resolución horizontal (puntos por pulgada). El ancho físico, medido en pulgadas, de una imagen es el ancho de píxel dividido por la resolución horizontal. Por ejemplo, una imagen con un ancho de píxel de 216 y una resolución horizontal de 72 puntos por pulgada tiene un ancho físico de 3 pulgadas. Los comentarios similares se aplican al alto de píxeles y al alto físico.

El DrawImageUnscaled método dibuja una imagen con su tamaño físico, por lo que la imagen tendrá su tamaño correcto en pulgadas, independientemente de la resolución (puntos por pulgada) del dispositivo de pantalla. Por ejemplo, supongamos que una imagen tiene un ancho de píxel de 216 y una resolución horizontal de 72 puntos por pulgada. Si llamas DrawImageUnscaled a para dibujar esa imagen en un dispositivo que tenga una resolución de 96 puntos por pulgada, el ancho de píxel de la imagen representada será (216/72)*96 = 288.