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 屬性指定左上角。 Width 和 Height 屬性會被忽略。

例外狀況

ArgumentNullException

image 為 null。

備註

會 Image 儲存圖元寬度的值，以及水平解析度的值， (英吋的點數) 。 以英吋為單位的影像實體寬度是像素寬度除以水平解析度。 例如，圖元寬度為 216 且水準解析度為每英吋 72 點的影像，實體寬度為 3 英吋。 類似的備註適用於圖元高度和實體高度。

DrawImageUnscaled方法會使用其實體大小繪製影像，因此不論顯示器裝置的解析度 (每英吋的點數) 解析度為何，影像都會有正確的大小。 例如，假設影像的圖元寬度為 216，而水平解析度為每英吋 72 點。 如果您在 DrawImageUnscaled 解析度為每英吋 96 點的裝置上繪製該影像，轉譯影像的圖元寬度將會 (216/72) *96 = 288。