Graphics.DrawImageUnscaled 方法

參考

定義

命名空間:: System.Drawing

組件:: System.Drawing.Common.dll

組件:: System.Drawing.dll

套件:: System.Drawing.Common v8.0.8

套件:: System.Drawing.Common v9.0.0-rc.1.24451.1

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

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

多載

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

DrawImageUnscaled(Image, Int32, Int32)

來源:: Graphics.cs

來源:: Graphics.cs

來源:: Graphics.cs

來源:: Graphics.cs

來源:: 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

來源:: Graphics.cs

來源:: Graphics.cs

來源:: Graphics.cs

來源:: 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。

備註

適用於

DrawImageUnscaled(Image, Point)

來源:: Graphics.cs

來源:: Graphics.cs

來源:: Graphics.cs

來源:: Graphics.cs

來源:: 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

備註

適用於

DrawImageUnscaled(Image, Rectangle)

來源:: Graphics.cs

來源:: Graphics.cs

來源:: Graphics.cs

來源:: Graphics.cs

來源:: 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。

備註

適用於

共用方式為

Graphics.DrawImageUnscaled 方法

定義

多載

DrawImageUnscaled(Image, Int32, Int32)

參數

例外狀況

範例

備註

適用於

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

參數

例外狀況

備註

適用於

DrawImageUnscaled(Image, Point)

參數

例外狀況

範例

備註

適用於

DrawImageUnscaled(Image, Rectangle)

參數

例外狀況

備註

適用於

其他資源