Graphics.DrawImageUnscaled Метод

Определение

Пространство имен:

System.Drawing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v8.0.0

Рисует заданное изображение, используя его исходный фактический размер, в месте, указанном парой координат.

Перегрузки

DrawImageUnscaled(Image, Int32, Int32)	Рисует заданное изображение, используя его исходный фактический размер, в месте, указанном парой координат.
DrawImageUnscaled(Image, Int32, Int32, Int32, Int32)	Рисует заданное изображение в заданном месте, используя его исходный фактический размер.
DrawImageUnscaled(Image, Point)	Рисует заданное изображение в заданном месте, используя его исходный фактический размер.
DrawImageUnscaled(Image, Rectangle)	Рисует заданное изображение в заданном месте, используя его исходный фактический размер.

DrawImageUnscaled(Image, Int32, Int32)

Исходный код:

Graphics.cs

Рисует заданное изображение, используя его исходный фактический размер, в месте, указанном парой координат.

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)

Параметры

image

Image

Объект Image для рисования.

x

Int32

Координата X верхнего левого угла формируемого изображения.

y

Int32

Координата Y верхнего левого угла формируемого изображения.

Исключения

ArgumentNullException

image имеет значение null.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика Paint событий. Код выполняет следующие действия.

• Создает изображение из JPEG-файла, SampImag.jpg, в папке примера.

• Создает точку для рисования левого верхнего угла изображения.

• Рисует все изображение, используя его физический размер.

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

Комментарии

Хранит Image значение ширины пикселей и значение горизонтального разрешения (точек на дюйм). Физическая ширина изображения, измеряемая в дюймах, — это ширина в пикселях, делимая на горизонтальное разрешение. Например, изображение с шириной в 216 пикселей и горизонтальным разрешением 72 точек на дюйм имеет физическую ширину 3 дюйма. Аналогичные замечания относятся к высоте пикселей и физической высоте.

Метод DrawImageUnscaled рисует изображение с использованием его физического размера, поэтому изображение будет иметь правильный размер в дюймах независимо от разрешения (точек на дюйм) устройства дисплея. Например, предположим, что ширина изображения составляет 216 пикселей, а разрешение по горизонтали составляет 72 точки на дюйм. Если вы вызываете для DrawImageUnscaled рисования этого изображения на устройстве с разрешением 96 точек на дюйм, ширина пикселя отображаемого изображения будет равна (216/72)*96 = 288.

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

Исходный код:

Graphics.cs

Рисует заданное изображение в заданном месте, используя его исходный фактический размер.

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)

Параметры

image

Image

Объект Image для рисования.

x

Int32

Координата X верхнего левого угла формируемого изображения.

y

Int32

Координата Y верхнего левого угла формируемого изображения.

width

Int32

Не используется.

height

Int32

Не используется.

Исключения

ArgumentNullException

image имеет значение null.

Комментарии

Хранит Image значение ширины пикселей и значение горизонтального разрешения (точек на дюйм). Физическая ширина изображения, измеряемая в дюймах, — это ширина в пикселях, делимая на горизонтальное разрешение. Например, изображение с шириной в 216 пикселей и горизонтальным разрешением 72 точек на дюйм имеет физическую ширину 3 дюйма. Аналогичные замечания относятся к высоте пикселей и физической высоте.

Метод DrawImageUnscaled рисует изображение с использованием его физического размера, поэтому изображение будет иметь правильный размер в дюймах независимо от разрешения (точек на дюйм) устройства дисплея. Например, предположим, что ширина изображения составляет 216 пикселей, а разрешение по горизонтали составляет 72 точки на дюйм. Если вы вызываете для DrawImageUnscaled рисования этого изображения на устройстве с разрешением 96 точек на дюйм, ширина пикселя отображаемого изображения будет равна (216/72)*96 = 288.

DrawImageUnscaled(Image, Point)

Исходный код:

Graphics.cs

Рисует заданное изображение в заданном месте, используя его исходный фактический размер.

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)

Параметры

image

Image

Объект Image для рисования.

point

Point

Структура Point, задающая верхний левый угол создаваемого рисунка.

Исключения

ArgumentNullException

image имеет значение null.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика Paint событий. Код выполняет следующие действия.

• Создает изображение из JPEG-файла, SampImag.jpg в папке примера.

• Создает точку для рисования левого верхнего угла изображения.

• Рисует все изображение, используя его физический размер.

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

Комментарии

Хранит Image значение ширины пикселей и значение горизонтального разрешения (точек на дюйм). Физическая ширина изображения, измеряемая в дюймах, — это ширина в пикселях, делимая на горизонтальное разрешение. Например, изображение с шириной в 216 пикселей и горизонтальным разрешением 72 точек на дюйм имеет физическую ширину 3 дюйма. Аналогичные замечания относятся к высоте пикселей и физической высоте.

Метод DrawImageUnscaled рисует изображение с использованием его физического размера, поэтому изображение будет иметь правильный размер в дюймах независимо от разрешения (точек на дюйм) устройства дисплея. Например, предположим, что ширина изображения составляет 216 пикселей, а разрешение по горизонтали составляет 72 точки на дюйм. Если вы вызываете для DrawImageUnscaled рисования этого изображения на устройстве с разрешением 96 точек на дюйм, ширина пикселя отображаемого изображения будет равна (216/72)*96 = 288.

DrawImageUnscaled(Image, Rectangle)

Исходный код:

Graphics.cs

Рисует заданное изображение в заданном месте, используя его исходный фактический размер.

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)

Параметры

image

Image

Объект Image для рисования.

rect

Rectangle

Структура Rectangle, задающая верхний левый угол создаваемого рисунка. Свойства X и Y прямоугольника определяют верхний левый угол. Свойства ширины и высоты не обрабатываются.

Исключения

ArgumentNullException

image имеет значение null.

Комментарии

Хранит Image значение ширины пикселей и значение горизонтального разрешения (точек на дюйм). Физическая ширина изображения, измеряемая в дюймах, — это ширина в пикселях, делимая на горизонтальное разрешение. Например, изображение с шириной в 216 пикселей и горизонтальным разрешением 72 точек на дюйм имеет физическую ширину 3 дюйма. Аналогичные замечания относятся к высоте пикселей и физической высоте.

Метод DrawImageUnscaled рисует изображение с использованием его физического размера, поэтому изображение будет иметь правильный размер в дюймах независимо от разрешения (точек на дюйм) устройства дисплея. Например, предположим, что ширина изображения составляет 216 пикселей, а разрешение по горизонтали составляет 72 точки на дюйм. Если вы вызываете для DrawImageUnscaled рисования этого изображения на устройстве с разрешением 96 точек на дюйм, ширина пикселя отображаемого изображения будет равна (216/72)*96 = 288.