Graphics.DrawImageUnscaled 方法

定義

命名空間:

System.Drawing

組件:

System.Drawing.Common.dll

套件:

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

使用其原始實體大小，在座標組所指定的位置繪製指定的影像。

多載

DrawImageUnscaled(Image, Int32, Int32)	使用其原始實體大小，在座標組所指定的位置繪製指定的影像。
DrawImageUnscaled(Image, Int32, Int32, Int32, Int32)	使用指定位置的原始實體大小繪製指定的影像。
DrawImageUnscaled(Image, Point)	使用指定位置的原始實體大小繪製指定的影像。
DrawImageUnscaled(Image, Rectangle)	使用指定位置的原始實體大小繪製指定的影像。

DrawImageUnscaled(Image, Int32, Int32)

來源:

Graphics.cs

使用其原始實體大小，在座標組所指定的位置繪製指定的影像。

C#

public void DrawImageUnscaled (System.Drawing.Image image, int x, int y);

參數

image

Image

要繪製的 Image。

x

Int32

繪製影像左上角的 X 座標。

y

Int32

繪製影像左上角的 Y 座標。

例外狀況

ArgumentNullException

image null。

範例

下列程式代碼範例是專為搭配 Windows Forms 使用而設計，而且需要 PaintEventArgse，這是 Paint 事件處理程式的參數。 程式代碼會執行下列動作：

• 從範例資料夾中的 JPEG 檔案 SampImag.jpg建立映像。

• 建立要繪製影像左上角的點。

• 使用其實體大小繪製整個影像。

C#

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);
}

備註

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

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

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

來源:

Graphics.cs

使用指定位置的原始實體大小繪製指定的影像。

C#

public void DrawImageUnscaled (System.Drawing.Image image, int x, int y, int width, int height);

參數

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

使用指定位置的原始實體大小繪製指定的影像。

C#

public void DrawImageUnscaled (System.Drawing.Image image, System.Drawing.Point point);

參數

image

Image

要繪製的 Image。

point

Point

Point 結構，指定繪製影像的左上角。

例外狀況

ArgumentNullException

image null。

範例

下列程式代碼範例是專為搭配 Windows Forms 使用而設計，而且需要 PaintEventArgse，這是 Paint 事件處理程式的參數。 程式代碼會執行下列動作：

• 從範例資料夾中的 JPEG 檔案 SampImag.jpg 建立映像。

• 建立要繪製影像左上角的點。

• 使用其實體大小繪製整個影像。

C#

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);
}

備註

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

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

DrawImageUnscaled(Image, Rectangle)

來源:

Graphics.cs

使用指定位置的原始實體大小繪製指定的影像。

C#

public void DrawImageUnscaled (System.Drawing.Image image, System.Drawing.Rectangle rect);

參數

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。