Aracılığıyla paylaş


Graphics.DrawImage Yöntem

Tanım

Belirtilen Image belirtilen konumda ve özgün boyutuyla çizer.

Aşırı Yüklemeler

DrawImage(Image, Single, Single, RectangleF, GraphicsUnit)

Görüntünün belirli bir konuma bir bölümünü çizer.

DrawImage(Image, Effect, RectangleF, Matrix, GraphicsUnit, ImageAttributes)
DrawImage(Image, Point[], Rectangle, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort)

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

DrawImage(Image, PointF[], RectangleF, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort)

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

DrawImage(Image, Point[], Rectangle, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort, Int32)

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

DrawImage(Image, PointF[], RectangleF, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort, Int32)

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

DrawImage(Image, Rectangle, Int32, Int32, Int32, Int32, GraphicsUnit)

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

DrawImage(Image, Rectangle, Int32, Int32, Int32, Int32, GraphicsUnit, ImageAttributes)

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

DrawImage(Image, Rectangle, Single, Single, Single, Single, GraphicsUnit, ImageAttributes)

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

DrawImage(Image, Rectangle, Int32, Int32, Int32, Int32, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort)

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

DrawImage(Image, Rectangle, Single, Single, Single, Single, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort)

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

DrawImage(Image, Rectangle, Int32, Int32, Int32, Int32, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort, IntPtr)

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

DrawImage(Image, Rectangle, Single, Single, Single, Single, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort, IntPtr)

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

DrawImage(Image, Rectangle, Single, Single, Single, Single, GraphicsUnit)

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

DrawImage(Image, Int32, Int32, Int32, Int32)

Belirtilen Image belirtilen konumda ve belirtilen boyutta çizer.

DrawImage(Image, Single, Single, Single, Single)

Belirtilen Image belirtilen konumda ve belirtilen boyutta çizer.

DrawImage(Image, PointF[], RectangleF, GraphicsUnit, ImageAttributes)

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

DrawImage(Image, Effect)
DrawImage(Image, Point)

Belirtilen Image, belirtilen konumda özgün fiziksel boyutunu kullanarak çizer.

DrawImage(Image, Point[])

Belirtilen Image belirtilen konumda ve belirtilen şekil ve boyutla çizer.

DrawImage(Image, PointF)

Belirtilen Image, belirtilen konumda özgün fiziksel boyutunu kullanarak çizer.

DrawImage(Image, PointF[])

Belirtilen Image belirtilen konumda ve belirtilen şekil ve boyutla çizer.

DrawImage(Image, Rectangle)

Belirtilen Image belirtilen konumda ve belirtilen boyutta çizer.

DrawImage(Image, RectangleF)

Belirtilen Image belirtilen konumda ve belirtilen boyutta çizer.

DrawImage(Image, Int32, Int32, Rectangle, GraphicsUnit)

Görüntünün belirli bir konuma bir bölümünü çizer.

DrawImage(Image, Single, Single)

Belirtilen Image, belirtilen konumda özgün fiziksel boyutunu kullanarak çizer.

DrawImage(Image, Point[], Rectangle, GraphicsUnit)

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

DrawImage(Image, PointF[], RectangleF, GraphicsUnit)

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

DrawImage(Image, Rectangle, Rectangle, GraphicsUnit)

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

DrawImage(Image, RectangleF, RectangleF, GraphicsUnit)

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

DrawImage(Image, Int32, Int32)

Belirtilen görüntüyü özgün fiziksel boyutunu kullanarak koordinat çifti tarafından belirtilen konuma çizer.

DrawImage(Image, Point[], Rectangle, GraphicsUnit, ImageAttributes)

Belirtilen konumda belirtilen Image belirtilen bölümünü çizer.

DrawImage(Image, Single, Single, RectangleF, GraphicsUnit)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Görüntünün belirli bir konuma bir bölümünü çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, float x, float y, System::Drawing::RectangleF srcRect, System::Drawing::GraphicsUnit srcUnit);
public void DrawImage (System.Drawing.Image image, float x, float y, System.Drawing.RectangleF srcRect, System.Drawing.GraphicsUnit srcUnit);
member this.DrawImage : System.Drawing.Image * single * single * System.Drawing.RectangleF * System.Drawing.GraphicsUnit -> unit
Public Sub DrawImage (image As Image, x As Single, y As Single, srcRect As RectangleF, srcUnit As GraphicsUnit)

Parametreler

image
Image

Çizmek için Image.

x
Single

Çizilen görüntünün sol üst köşesinin x koordinatı.

y
Single

Çizilen görüntünün sol üst köşesinin y koordinatı.

srcRect
RectangleF

Çizecek Image bölümünü belirten RectangleF yapısı.

srcUnit
GraphicsUnit

srcRect parametresi tarafından kullanılan ölçü birimlerini belirten GraphicsUnit numaralandırmasının üyesi.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Görüntünün sol üst köşesini çizmek için koordinatları oluşturur.

  • Görüntünün bir bölümünü ayıklamak için kaynak dikdörtgen oluşturur.

  • Kaynak dikdörtgenin ölçü birimini piksel olarak ayarlar.

  • Görüntüyü ekrana çizer.

Kaynak dikdörtgenin boyutu, ölçeklendirilmemiş özgün görüntünün hangi bölümünün ekrana çizileceğini belirler.

public:
   void DrawImage2FloatRectF( PaintEventArgs^ e )
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create coordinates for upper-left corner of image.
      float x = 100.0F;
      float y = 100.0F;

      // Create rectangle for source image.
      RectangleF srcRect = RectangleF(50.0F,50.0F,150.0F,150.0F);
      GraphicsUnit units = GraphicsUnit::Pixel;

      // Draw image to screen.
      e->Graphics->DrawImage( newImage, x, y, srcRect, units );
   }
public void DrawImage2FloatRectF(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create coordinates for upper-left corner of image.
    float x = 100.0F;
    float y = 100.0F;
             
    // Create rectangle for source image.
    RectangleF srcRect = new RectangleF(50.0F, 50.0F, 150.0F, 150.0F);
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Draw image to screen.
    e.Graphics.DrawImage(newImage, x, y, srcRect, units);
}
Public Sub DrawImage2FloatRectF(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 Single = 100.0F
    Dim y As Single = 100.0F

    ' Create rectangle for source image.
    Dim srcRect As New RectangleF(50.0F, 50.0F, 150.0F, 150.0F)
    Dim units As GraphicsUnit = GraphicsUnit.Pixel

    ' Draw image to screen.
    e.Graphics.DrawImage(newImage, x, y, srcRect, units)
End Sub

Açıklamalar

Image, piksel genişliği için bir değer ve yatay çözünürlük için bir değer (inç başına nokta) depolar. Bir görüntünün inç cinsinden ölçülen fiziksel genişliği, yatay çözünürlüğe bölünen piksel genişliğidir. Örneğin, piksel genişliği 360 olan ve yatay çözünürlüğü inç başına 72 nokta olan bir görüntünün fiziksel genişliği 5 inçtir. Benzer açıklamalar piksel yüksekliği ve fiziksel yükseklik için de geçerlidir.

Bu yöntem, fiziksel boyutunu kullanarak görüntünün bir bölümünü çizer, dolayısıyla görüntü bölümünün boyutu, görüntü cihazının çözünürlüğünden (inç başına nokta sayısı) bağımsız olarak inç cinsinden doğru boyutuna sahip olur. Örneğin, bir görüntü bölümünün piksel genişliği 216 ve yatay çözünürlüğü inç başına 72 nokta olduğunu varsayalım. Bu görüntü bölümünü inç başına 96 nokta çözünürlüğüne sahip bir cihaza çizmek için bu yöntemi çağırırsanız, işlenen görüntü bölümünün piksel genişliği (216/72)*96 = 288 olur.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, Effect, RectangleF, Matrix, GraphicsUnit, ImageAttributes)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
public void DrawImage (System.Drawing.Image image, System.Drawing.Imaging.Effects.Effect effect, System.Drawing.RectangleF srcRect = default, System.Drawing.Drawing2D.Matrix? transform = default, System.Drawing.GraphicsUnit srcUnit = System.Drawing.GraphicsUnit.Pixel, System.Drawing.Imaging.ImageAttributes? imageAttr = default);
member this.DrawImage : System.Drawing.Image * System.Drawing.Imaging.Effects.Effect * System.Drawing.RectangleF * System.Drawing.Drawing2D.Matrix * System.Drawing.GraphicsUnit * System.Drawing.Imaging.ImageAttributes -> unit
Public Sub DrawImage (image As Image, effect As Effect, Optional srcRect As RectangleF = Nothing, Optional transform As Matrix = Nothing, Optional srcUnit As GraphicsUnit = System.Drawing.GraphicsUnit.Pixel, Optional imageAttr As ImageAttributes = Nothing)

Parametreler

image
Image
effect
Effect
srcRect
RectangleF
transform
Matrix
srcUnit
GraphicsUnit
imageAttr
ImageAttributes

Şunlara uygulanır

DrawImage(Image, Point[], Rectangle, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, cli::array <System::Drawing::Point> ^ destPoints, System::Drawing::Rectangle srcRect, System::Drawing::GraphicsUnit srcUnit, System::Drawing::Imaging::ImageAttributes ^ imageAttr, System::Drawing::Graphics::DrawImageAbort ^ callback);
public void DrawImage (System.Drawing.Image image, System.Drawing.Point[] destPoints, System.Drawing.Rectangle srcRect, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes? imageAttr, System.Drawing.Graphics.DrawImageAbort? callback);
public void DrawImage (System.Drawing.Image image, System.Drawing.Point[] destPoints, System.Drawing.Rectangle srcRect, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes imageAttr, System.Drawing.Graphics.DrawImageAbort callback);
member this.DrawImage : System.Drawing.Image * System.Drawing.Point[] * System.Drawing.Rectangle * System.Drawing.GraphicsUnit * System.Drawing.Imaging.ImageAttributes * System.Drawing.Graphics.DrawImageAbort -> unit
Public Sub DrawImage (image As Image, destPoints As Point(), srcRect As Rectangle, srcUnit As GraphicsUnit, imageAttr As ImageAttributes, callback As Graphics.DrawImageAbort)

Parametreler

image
Image

Çizmek için Image.

destPoints
Point[]

Paralelkenar tanımlayan üç PointF yapısı dizisi.

srcRect
Rectangle

Çizecek image nesnesinin bölümünü belirten Rectangle yapı.

srcUnit
GraphicsUnit

srcRect parametresi tarafından kullanılan ölçü birimlerini belirten GraphicsUnit numaralandırmasının üyesi.

imageAttr
ImageAttributes

image nesnesi için yeniden renklendirme ve gama bilgilerini belirten ImageAttributes.

callback
Graphics.DrawImageAbort

görüntünün çizimi sırasında çağrılacak bir yöntem belirten Graphics.DrawImageAbort temsilcisi. Bu yöntem, uygulama tarafından belirlenen ölçütlere göre DrawImage(Image, Point[], Rectangle, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort) yönteminin yürütülmesinin durdurulup durdurulmayacağını denetlemek için sık sık çağrılır.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod ilk olarak Graphics.DrawImageAbort temsilcisi için bir geri çağırma yöntemi tanımlar; tanımı basittir ve yalnızca DrawImage yönteminin null callBackData parametresiyle çağırıp çağırmadığını test eder. Örneğin ana gövdesi aşağıdaki eylemleri gerçekleştirir:

  • Graphics.DrawImageAbort geri çağırma yönteminin bir örneğini oluşturur:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Görüntüyü çizmek için bir paralelogram tanımlayan noktalar oluşturur.

  • Resmin çizecek bölümünü seçmek için bir dikdörtgen oluşturur.

  • Grafik çizim birimini piksel olarak ayarlar.

  • Özgün görüntüyü ekrana çizer.

  • Ayarlanmış bir görüntünün çizildiği ek bir paralelogram oluşturur.

  • Düzeltilmiş görüntünün özniteliklerini oluşturur ve her zamankinden daha büyük bir gama değerine sahip olacak şekilde ayarlar.

  • Ayarlanmış görüntüyü ekrana çizer.

Özgün, ayarsız paralel grafik için, konum görüntüyü ekranda bulur ve dikdörtgenin boyutu ile paralel grafiğin boyutu ve şekli, çizilen görüntünün ölçeklendirilip kırpılma durumunu belirler.

Bu örnekte callBackData parametresi geçirmeyen bir aşırı yükleme kullanıldığından, geri çağırma Graphics.DrawImageAborttruedöndürür. Bu da DrawImage yönteminin sona ermesini sağlar ve örnekte yer alan özel durum işleme kodu görüntüyü çizmek yerine özel durum metnini yazdırır.

   // Define DrawImageAbort callback method.
private:
   bool DrawImageCallback1( IntPtr callBackData )
   {
      // Test for call that passes callBackData parameter.
      if ( callBackData == IntPtr::Zero )
      {
         // If no callBackData passed, abort DrawImage method.
         return true;
      }
      else
      {
         // If callBackData passed, continue DrawImage method.
         return false;
      }
   }

private:
   void DrawImageParaRectAttribAbort( PaintEventArgs^ e )
   {
      // Create callback method.
      Graphics::DrawImageAbort^ imageCallback = gcnew Graphics::DrawImageAbort( this, &Form1::DrawImageCallback1 );

      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create parallelogram for drawing original image.
      Point ulCorner = Point(100,100);
      Point urCorner = Point(550,100);
      Point llCorner = Point(150,250);
      array<Point>^ destPara1 = {ulCorner,urCorner,llCorner};

      // Create rectangle for source image.
      Rectangle srcRect = Rectangle(50,50,150,150);
      GraphicsUnit units = GraphicsUnit::Pixel;

      // Draw original image to screen.
      e->Graphics->DrawImage( newImage, destPara1, srcRect, units );

      // Create parallelogram for drawing adjusted image.
      Point ulCorner2 = Point(325,100);
      Point urCorner2 = Point(550,100);
      Point llCorner2 = Point(375,250);
      array<Point>^ destPara2 = {ulCorner2,urCorner2,llCorner2};

      // Create image attributes and set large gamma.
      ImageAttributes^ imageAttr = gcnew ImageAttributes;
      imageAttr->SetGamma( 4.0F );
      try
      {
         // Draw image to screen.
         e->Graphics->DrawImage( newImage, destPara2, srcRect, units, imageAttr, imageCallback );
      }
      catch ( Exception^ ex ) 
      {
         e->Graphics->DrawString( ex->ToString(), gcnew System::Drawing::Font( "Arial",8 ), Brushes::Black, PointF(0,0) );
      }
   }

// Define DrawImageAbort callback method.
private bool DrawImageCallback1(IntPtr callBackData)
{
             
    // Test for call that passes callBackData parameter.
    if(callBackData==IntPtr.Zero)
    {
             
        // If no callBackData passed, abort DrawImage method.
        return true;
    }
    else
    {
             
        // If callBackData passed, continue DrawImage method.
        return false;
    }
}
private void DrawImageParaRectAttribAbort(PaintEventArgs e)
{
             
    // Create callback method.
    Graphics.DrawImageAbort imageCallback
        = new Graphics.DrawImageAbort(DrawImageCallback1);
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create parallelogram for drawing original image.
    Point ulCorner = new Point(100, 100);
    Point urCorner = new Point(550, 100);
    Point llCorner = new Point(150, 250);
    Point[] destPara1 = {ulCorner, urCorner, llCorner};
             
    // Create rectangle for source image.
    Rectangle srcRect = new Rectangle(50, 50, 150, 150);
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Draw original image to screen.
    e.Graphics.DrawImage(newImage, destPara1, srcRect, units);
             
    // Create parallelogram for drawing adjusted image.
    Point ulCorner2 = new Point(325, 100);
    Point urCorner2 = new Point(550, 100);
    Point llCorner2 = new Point(375, 250);
    Point[] destPara2 = {ulCorner2, urCorner2, llCorner2};
             
    // Create image attributes and set large gamma.
    ImageAttributes imageAttr = new ImageAttributes();
    imageAttr.SetGamma(4.0F);
    try
    {
        checked
        {
             
            // Draw image to screen.
            e.Graphics.DrawImage(
                newImage,
                destPara2,
                srcRect,
                units,
                imageAttr,
                imageCallback);
        }
    }
    catch (Exception ex)
    {
        e.Graphics.DrawString(
            ex.ToString(),
            new Font("Arial", 8),
            Brushes.Black,
            new PointF(0, 0));
    }
}
Private Function DrawImageCallback1(ByVal callBackData As IntPtr) As Boolean

    ' Test for call that passes callBackData parameter.
    If callBackData.Equals(IntPtr.Zero) Then

        ' If no callBackData passed, abort DrawImage method.
        Return True
    Else

        ' If callBackData passed, continue DrawImage method.
        Return False
    End If
End Function
Private Sub DrawImageParaRectAttribAbort(ByVal e As PaintEventArgs)

    ' Create callback method.
    Dim imageCallback As New _
    Graphics.DrawImageAbort(AddressOf DrawImageCallback1)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create parallelogram for drawing original image.
    Dim ulCorner As New Point(100, 100)
    Dim urCorner As New Point(550, 100)
    Dim llCorner As New Point(150, 250)
    Dim destPara1 As Point() = {ulCorner, urCorner, llCorner}

    ' Create rectangle for source image.
    Dim srcRect As New Rectangle(50, 50, 150, 150)
    Dim units As GraphicsUnit = GraphicsUnit.Pixel

    ' Draw original image to screen.
    e.Graphics.DrawImage(newImage, destPara1, srcRect, units)

    ' Create parallelogram for drawing adjusted image.
    Dim ulCorner2 As New Point(325, 100)
    Dim urCorner2 As New Point(550, 100)
    Dim llCorner2 As New Point(375, 250)
    Dim destPara2 As Point() = {ulCorner2, urCorner2, llCorner2}

    ' Create image attributes and set large gamma.
    Dim imageAttr As New ImageAttributes
    imageAttr.SetGamma(4.0F)
    Try

        ' Draw image to screen.
        e.Graphics.DrawImage(newImage, destPara2, srcRect, units, _
        imageAttr, imageCallback)
    Catch ex As Exception
        e.Graphics.DrawString(ex.ToString(), New Font("Arial", 8), _
        Brushes.Black, New PointF(0, 0))
    End Try
End Sub

Açıklamalar

destPoints parametresi paralelkenarın üç noktasını belirtir. Üç PointF yapısı, paralelkenarın sol üst, sağ üst ve sol alt köşelerini temsil eder. Dördüncü nokta, paralelkenar oluşturmak için ilk üç noktadan elde edilir.

srcRect parametresi, çizecek image nesnesinin dikdörtgen bir bölümünü belirtir. Bu bölüm ölçeklendirilir ve destPoints parametresi tarafından belirtilen paralelkenarın içine sığacak şekilde yamlanır.

callback parametresiyle yapılan bu aşırı yükleme, uygulama tarafından belirlenen ölçütlere göre başladıktan sonra görüntünün çizimini durdurma araçları sağlar. Örneğin, bir uygulama büyük bir görüntü çizmeye başlayabilir ve kullanıcı görüntüyü ekrandan kaydırabilir ve bu durumda uygulama çizimi durdurabilir.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, PointF[], RectangleF, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, cli::array <System::Drawing::PointF> ^ destPoints, System::Drawing::RectangleF srcRect, System::Drawing::GraphicsUnit srcUnit, System::Drawing::Imaging::ImageAttributes ^ imageAttr, System::Drawing::Graphics::DrawImageAbort ^ callback);
public void DrawImage (System.Drawing.Image image, System.Drawing.PointF[] destPoints, System.Drawing.RectangleF srcRect, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes? imageAttr, System.Drawing.Graphics.DrawImageAbort? callback);
public void DrawImage (System.Drawing.Image image, System.Drawing.PointF[] destPoints, System.Drawing.RectangleF srcRect, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes imageAttr, System.Drawing.Graphics.DrawImageAbort callback);
member this.DrawImage : System.Drawing.Image * System.Drawing.PointF[] * System.Drawing.RectangleF * System.Drawing.GraphicsUnit * System.Drawing.Imaging.ImageAttributes * System.Drawing.Graphics.DrawImageAbort -> unit
Public Sub DrawImage (image As Image, destPoints As PointF(), srcRect As RectangleF, srcUnit As GraphicsUnit, imageAttr As ImageAttributes, callback As Graphics.DrawImageAbort)

Parametreler

image
Image

Çizmek için Image.

destPoints
PointF[]

Paralelkenar tanımlayan üç PointF yapısı dizisi.

srcRect
RectangleF

Çizecek image nesnesinin bölümünü belirten RectangleF yapı.

srcUnit
GraphicsUnit

srcRect parametresi tarafından kullanılan ölçü birimlerini belirten GraphicsUnit numaralandırmasının üyesi.

imageAttr
ImageAttributes

image nesnesi için yeniden renklendirme ve gama bilgilerini belirten ImageAttributes.

callback
Graphics.DrawImageAbort

görüntünün çizimi sırasında çağrılacak bir yöntem belirten Graphics.DrawImageAbort temsilcisi. Bu yöntem, uygulama tarafından belirlenen ölçütlere göre DrawImage(Image, PointF[], RectangleF, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort) yönteminin yürütülmesinin durdurulup durdurulmayacağını denetlemek için sık sık çağrılır.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod ilk olarak Graphics.DrawImageAbort temsilcisi için bir geri çağırma yöntemi tanımlar; tanımı basittir ve yalnızca DrawImage yönteminin null callBackData parametresiyle çağırıp çağırmadığını test eder. Örneğin ana gövdesi aşağıdaki eylemleri gerçekleştirir:

  • Graphics.DrawImageAbort geri çağırma yönteminin bir örneğini oluşturur.

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Görüntüyü çizmek için bir paralelogram tanımlayan noktalar oluşturur.

  • Resmin çizecek bölümünü seçmek için bir dikdörtgen oluşturur.

  • Grafik çizim birimini piksel olarak ayarlar.

  • Özgün görüntüyü ekrana çizer.

  • Ayarlanmış bir görüntünün çizildiği ek bir paralelogram oluşturur.

  • Düzeltilmiş görüntünün özniteliklerini oluşturur ve her zamankinden daha büyük bir gama değerine sahip olacak şekilde ayarlar.

  • Ayarlanmış görüntüyü ekrana çizer.

Özgün, ayarsız paralel grafik için, konum görüntüyü ekranda bulur ve dikdörtgenin boyutu ile paralel grafiğin boyutu ve şekli, çizilen görüntünün ölçeklendirilip kırpılma durumunu belirler.

Bu örnekte callBackData parametresi geçirmeyen bir aşırı yükleme kullanıldığından, geri çağırma Graphics.DrawImageAborttruedöndürür. Bu da DrawImage yönteminin sona ermesini sağlar ve örnekte yer alan özel durum işleme kodu görüntüyü çizmek yerine özel durum metnini yazdırır.

   // Define DrawImageAbort callback method.
private:
   bool DrawImageCallback3( IntPtr callBackData )
   {
      // Test for call that passes callBackData parameter.
      if ( callBackData == IntPtr::Zero )
      {
         // If no callBackData passed, abort DrawImage method.
         return true;
      }
      else
      {
         // If callBackData passed, continue DrawImage method.
         return false;
      }
   }

private:
   void DrawImageParaFRectAttribAbort( PaintEventArgs^ e )
   {
      // Create callback method.
      Graphics::DrawImageAbort^ imageCallback = gcnew Graphics::DrawImageAbort( this, &Form1::DrawImageCallback3 );

      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create parallelogram for drawing original image.
      PointF ulCorner1 = PointF(100.0F,100.0F);
      PointF urCorner1 = PointF(325.0F,100.0F);
      PointF llCorner1 = PointF(150.0F,250.0F);
      array<PointF>^ destPara1 = {ulCorner1,urCorner1,llCorner1};

      // Create rectangle for source image.
      RectangleF srcRect = RectangleF(50.0F,50.0F,150.0F,150.0F);
      GraphicsUnit units = GraphicsUnit::Pixel;

      // Create parallelogram for drawing adjusted image.
      PointF ulCorner2 = PointF(325.0F,100.0F);
      PointF urCorner2 = PointF(550.0F,100.0F);
      PointF llCorner2 = PointF(375.0F,250.0F);
      array<PointF>^ destPara2 = {ulCorner2,urCorner2,llCorner2};

      // Draw original image to screen.
      e->Graphics->DrawImage( newImage, destPara1, srcRect, units );

      // Create image attributes and set large gamma.
      ImageAttributes^ imageAttr = gcnew ImageAttributes;
      imageAttr->SetGamma( 4.0F );
      try
      {
         // Draw adjusted image to screen.
         e->Graphics->DrawImage( newImage, destPara2, srcRect, units, imageAttr, imageCallback );
      }
      catch ( Exception^ ex ) 
      {
         e->Graphics->DrawString( ex->ToString(), gcnew System::Drawing::Font( "Arial",8 ), Brushes::Black, PointF(0,0) );
      }
   }

// Define DrawImageAbort callback method.
private bool DrawImageCallback3(IntPtr callBackData)
{
             
    // Test for call that passes callBackData parameter.
    if(callBackData==IntPtr.Zero)
    {
             
        // If no callBackData passed, abort DrawImage method.
        return true;
    }
    else
    {
             
        // If callBackData passed, continue DrawImage method.
        return false;
    }
}
private void DrawImageParaFRectAttribAbort(PaintEventArgs e)
{
             
    // Create callback method.
    Graphics.DrawImageAbort imageCallback
        = new Graphics.DrawImageAbort(DrawImageCallback3);
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create parallelogram for drawing original image.
    PointF ulCorner1 = new PointF(100.0F, 100.0F);
    PointF urCorner1 = new PointF(325.0F, 100.0F);
    PointF llCorner1 = new PointF(150.0F, 250.0F);
    PointF[] destPara1 = {ulCorner1, urCorner1, llCorner1};
             
    // Create rectangle for source image.
    RectangleF srcRect = new RectangleF(50.0F, 50.0F, 150.0F, 150.0F);
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Create parallelogram for drawing adjusted image.
    PointF ulCorner2 = new PointF(325.0F, 100.0F);
    PointF urCorner2 = new PointF(550.0F, 100.0F);
    PointF llCorner2 = new PointF(375.0F, 250.0F);
    PointF[] destPara2 = {ulCorner2, urCorner2, llCorner2};
             
    // Draw original image to screen.
    e.Graphics.DrawImage(newImage, destPara1, srcRect, units);
             
    // Create image attributes and set large gamma.
    ImageAttributes imageAttr = new ImageAttributes();
    imageAttr.SetGamma(4.0F);
    try
    {
        checked
        {
             
            // Draw adjusted image to screen.
            e.Graphics.DrawImage(
                newImage,
                destPara2,
                srcRect,
                units,
                imageAttr,
                imageCallback);
        }
    }
    catch (Exception ex)
    {
        e.Graphics.DrawString(
            ex.ToString(),
            new Font("Arial", 8),
            Brushes.Black,
            new PointF(0, 0));
    }
}
Private Function DrawImageCallback3(ByVal callBackData As IntPtr) As Boolean

    ' Test for call that passes callBackData parameter.
    If callBackData.Equals(IntPtr.Zero) Then

        ' If no callBackData passed, abort DrawImage method.
        Return True
    Else

        ' If callBackData passed, continue DrawImage method.
        Return False
    End If
End Function
Private Sub DrawImageParaFRectAttribAbort(ByVal e As PaintEventArgs)

    ' Create callback method.
    Dim imageCallback As New _
    Graphics.DrawImageAbort(AddressOf DrawImageCallback3)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create parallelogram for drawing original image.
    Dim ulCorner1 As New PointF(100.0F, 100.0F)
    Dim urCorner1 As New PointF(325.0F, 100.0F)
    Dim llCorner1 As New PointF(150.0F, 250.0F)
    Dim destPara1 As PointF() = {ulCorner1, urCorner1, llCorner1}

    ' Create rectangle for source image.
    Dim srcRect As New RectangleF(50.0F, 50.0F, 150.0F, 150.0F)
    Dim units As GraphicsUnit = GraphicsUnit.Pixel

    ' Create parallelogram for drawing adjusted image.
    Dim ulCorner2 As New PointF(325.0F, 100.0F)
    Dim urCorner2 As New PointF(550.0F, 100.0F)
    Dim llCorner2 As New PointF(375.0F, 250.0F)
    Dim destPara2 As PointF() = {ulCorner2, urCorner2, llCorner2}

    ' Draw original image to screen.
    e.Graphics.DrawImage(newImage, destPara1, srcRect, units)

    ' Create image attributes and set large gamma.
    Dim imageAttr As New ImageAttributes
    imageAttr.SetGamma(4.0F)
    Try

        ' Draw adjusted image to screen.
        e.Graphics.DrawImage(newImage, destPara2, srcRect, units, _
        imageAttr, imageCallback)
    Catch ex As Exception
        e.Graphics.DrawString(ex.ToString(), New Font("Arial", 8), _
        Brushes.Black, New PointF(0, 0))
    End Try
End Sub

Açıklamalar

destPoints parametresi paralelkenarın üç noktasını belirtir. Üç PointF yapısı, paralelkenarın sol üst, sağ üst ve sol alt köşelerini temsil eder. Dördüncü nokta, paralelkenar oluşturmak için ilk üç noktadan elde edilir.

srcRect parametresi, çizecek image nesnesinin dikdörtgen bir bölümünü belirtir. Bu bölüm ölçeklendirilir ve destPoints parametresi tarafından belirtilen paralelkenarın içine sığacak şekilde yamlanır.

callback parametresiyle yapılan bu aşırı yükleme, uygulama tarafından belirlenen ölçütlere göre başladıktan sonra görüntünün çizimini durdurma araçları sağlar. Örneğin, bir uygulama büyük bir görüntü çizmeye başlayabilir ve kullanıcı görüntüyü ekrandan kaydırabilir ve bu durumda uygulama çizimi durdurabilir.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, Point[], Rectangle, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort, Int32)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, cli::array <System::Drawing::Point> ^ destPoints, System::Drawing::Rectangle srcRect, System::Drawing::GraphicsUnit srcUnit, System::Drawing::Imaging::ImageAttributes ^ imageAttr, System::Drawing::Graphics::DrawImageAbort ^ callback, int callbackData);
public void DrawImage (System.Drawing.Image image, System.Drawing.Point[] destPoints, System.Drawing.Rectangle srcRect, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes? imageAttr, System.Drawing.Graphics.DrawImageAbort? callback, int callbackData);
public void DrawImage (System.Drawing.Image image, System.Drawing.Point[] destPoints, System.Drawing.Rectangle srcRect, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes imageAttr, System.Drawing.Graphics.DrawImageAbort callback, int callbackData);
member this.DrawImage : System.Drawing.Image * System.Drawing.Point[] * System.Drawing.Rectangle * System.Drawing.GraphicsUnit * System.Drawing.Imaging.ImageAttributes * System.Drawing.Graphics.DrawImageAbort * int -> unit
Public Sub DrawImage (image As Image, destPoints As Point(), srcRect As Rectangle, srcUnit As GraphicsUnit, imageAttr As ImageAttributes, callback As Graphics.DrawImageAbort, callbackData As Integer)

Parametreler

image
Image

Çizmek için Image.

destPoints
Point[]

Paralelkenar tanımlayan üç PointF yapısı dizisi.

srcRect
Rectangle

Çizecek image nesnesinin bölümünü belirten Rectangle yapı.

srcUnit
GraphicsUnit

srcRect parametresi tarafından kullanılan ölçü birimlerini belirten GraphicsUnit numaralandırmasının üyesi.

imageAttr
ImageAttributes

image nesnesi için yeniden renklendirme ve gama bilgilerini belirten ImageAttributes.

callback
Graphics.DrawImageAbort

görüntünün çizimi sırasında çağrılacak bir yöntem belirten Graphics.DrawImageAbort temsilcisi. Bu yöntem, uygulama tarafından belirlenen ölçütlere göre DrawImage(Image, Point[], Rectangle, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort, Int32) yönteminin yürütülmesinin durdurulup durdurulmayacağını denetlemek için sık sık çağrılır.

callbackData
Int32

Graphics.DrawImageAbort temsilcisinin DrawImage(Image, Point[], Rectangle, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort, Int32) yönteminin yürütülmesini durdurup durdurmayacağını denetlerken kullanması gereken ek verileri belirten değer.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod ilk olarak Graphics.DrawImageAbort temsilcisi için bir geri çağırma yöntemi tanımlar; tanımı basittir ve yalnızca DrawImage yönteminin null callBackData parametresiyle çağırıp çağırmadığını test eder. Örneğin ana gövdesi aşağıdaki eylemleri gerçekleştirir:

  • Graphics.DrawImageAbort geri çağırma yönteminin bir örneğini oluşturur.

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Görüntüyü çizmek için bir paralelogram tanımlayan noktalar oluşturur.

  • Resmin çizecek bölümünü seçmek için bir dikdörtgen oluşturur.

  • Grafik çizim birimini piksel olarak ayarlar.

  • Özgün görüntüyü ekrana çizer.

  • Ayarlanmış bir görüntünün çizildiği ek bir paralelogram oluşturur.

  • Düzeltilmiş görüntünün özniteliklerini oluşturur ve her zamankinden daha büyük bir gama değerine sahip olacak şekilde ayarlar.

  • Ayarlanmış görüntüyü ekrana çizer.

Özgün, ayarsız paralel grafik için, konum görüntüyü ekranda bulur ve dikdörtgenin boyutu ile paralel grafiğin boyutu ve şekli, çizilen görüntünün ölçeklendirilip kırpılma durumunu belirler.

Bu örnekte callBackData parametresini geçiren bir aşırı yükleme kullanıldığından, geri çağırma Graphics.DrawImageAbortfalsedöndürür ve bu da DrawImage yönteminin devam etmesine neden olur ve örnek ayarlanan görüntüyü ekrana çizer.

   // Define DrawImageAbort callback method.
private:
   bool DrawImageCallback2( IntPtr callBackData )
   {
      // Test for call that passes callBackData parameter.
      if ( callBackData == IntPtr::Zero )
      {
         // If no callBackData passed, abort DrawImage method.
         return true;
      }
      else
      {
         // If callBackData passed, continue DrawImage method.
         return false;
      }
   }

private:
   void DrawImageParaRectAttribAbortData( PaintEventArgs^ e )
   {
      // Create callback method.
      Graphics::DrawImageAbort^ imageCallback = gcnew Graphics::DrawImageAbort( this, &Form1::DrawImageCallback2 );
      int imageCallbackData = 1;

      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create parallelogram for drawing original image.
      Point ulCorner = Point(100,100);
      Point urCorner = Point(550,100);
      Point llCorner = Point(150,250);
      array<Point>^ destPara1 = {ulCorner,urCorner,llCorner};

      // Create rectangle for source image.
      Rectangle srcRect = Rectangle(50,50,150,150);
      GraphicsUnit units = GraphicsUnit::Pixel;

      // Draw original image to screen.
      e->Graphics->DrawImage( newImage, destPara1, srcRect, units );

      // Create parallelogram for drawing adjusted image.
      Point ulCorner2 = Point(325,100);
      Point urCorner2 = Point(550,100);
      Point llCorner2 = Point(375,250);
      array<Point>^ destPara2 = {ulCorner2,urCorner2,llCorner2};

      // Create image attributes and set large gamma.
      ImageAttributes^ imageAttr = gcnew ImageAttributes;
      imageAttr->SetGamma( 4.0F );
      try
      {
         // Draw image to screen.
         e->Graphics->DrawImage( newImage, destPara2, srcRect, units, imageAttr, imageCallback, imageCallbackData );
      }
      catch ( Exception^ ex ) 
      {
         e->Graphics->DrawString( ex->ToString(), gcnew System::Drawing::Font( "Arial",8 ), Brushes::Black, PointF(0,0) );
      }
   }

// Define DrawImageAbort callback method.
private bool DrawImageCallback2(IntPtr callBackData)
{
             
    // Test for call that passes callBackData parameter.
    if(callBackData==IntPtr.Zero)
    {
             
        // If no callBackData passed, abort DrawImage method.
        return true;
    }
    else
    {
             
        // If callBackData passed, continue DrawImage method.
        return false;
    }
}
private void DrawImageParaRectAttribAbortData(PaintEventArgs e)
{
             
    // Create callback method.
    Graphics.DrawImageAbort imageCallback
        = new Graphics.DrawImageAbort(DrawImageCallback2);
    int imageCallbackData = 1;
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create parallelogram for drawing original image.
    Point ulCorner = new Point(100, 100);
    Point urCorner = new Point(550, 100);
    Point llCorner = new Point(150, 250);
    Point[] destPara1 = {ulCorner, urCorner, llCorner};
             
    // Create rectangle for source image.
    Rectangle srcRect = new Rectangle(50, 50, 150, 150);
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Draw original image to screen.
    e.Graphics.DrawImage(newImage, destPara1, srcRect, units);
             
    // Create parallelogram for drawing adjusted image.
    Point ulCorner2 = new Point(325, 100);
    Point urCorner2 = new Point(550, 100);
    Point llCorner2 = new Point(375, 250);
    Point[] destPara2 = {ulCorner2, urCorner2, llCorner2};
             
    // Create image attributes and set large gamma.
    ImageAttributes imageAttr = new ImageAttributes();
    imageAttr.SetGamma(4.0F);
    try
    {
        checked
        {
             
            // Draw image to screen.
            e.Graphics.DrawImage(
                newImage,
                destPara2,
                srcRect,
                units,
                imageAttr,
                imageCallback,
                imageCallbackData);
        }
    }
    catch (Exception ex)
    {
        e.Graphics.DrawString(
            ex.ToString(),
            new Font("Arial", 8),
            Brushes.Black,
            new PointF(0, 0));
    }
}
Private Function DrawImageCallback2(ByVal callBackData As IntPtr) As Boolean

    ' Test for call that passes callBackData parameter.
    If callBackData.Equals(IntPtr.Zero) Then

        ' If no callBackData passed, abort DrawImage method.
        Return True
    Else

        ' If callBackData passed, continue DrawImage method.
        Return False
    End If
End Function
Private Sub DrawImageParaRectAttribAbortData(ByVal e As PaintEventArgs)

    ' Create callback method.
    Dim imageCallback As New _
    Graphics.DrawImageAbort(AddressOf DrawImageCallback2)
    Dim imageCallbackData As Integer = 1

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create parallelogram for drawing original image.
    Dim ulCorner As New Point(100, 100)
    Dim urCorner As New Point(550, 100)
    Dim llCorner As New Point(150, 250)
    Dim destPara1 As Point() = {ulCorner, urCorner, llCorner}

    ' Create rectangle for source image.
    Dim srcRect As New Rectangle(50, 50, 150, 150)
    Dim units As GraphicsUnit = GraphicsUnit.Pixel

    ' Draw original image to screen.
    e.Graphics.DrawImage(newImage, destPara1, srcRect, units)

    ' Create parallelogram for drawing adjusted image.
    Dim ulCorner2 As New Point(325, 100)
    Dim urCorner2 As New Point(550, 100)
    Dim llCorner2 As New Point(375, 250)
    Dim destPara2 As Point() = {ulCorner2, urCorner2, llCorner2}

    ' Create image attributes and set large gamma.
    Dim imageAttr As New ImageAttributes
    imageAttr.SetGamma(4.0F)
    Try

        ' Draw image to screen.
        e.Graphics.DrawImage(newImage, destPara2, srcRect, units, _
        imageAttr, imageCallback, imageCallbackData)
    Catch ex As Exception
        e.Graphics.DrawString(ex.ToString(), New Font("Arial", 8), _
        Brushes.Black, New PointF(0, 0))
    End Try
End Sub

Açıklamalar

destPoints parametresi paralelkenarın üç noktasını belirtir. Üç PointF yapısı, paralelkenarın sol üst, sağ üst ve sol alt köşelerini temsil eder. Dördüncü nokta, paralelkenar oluşturmak için ilk üç noktadan elde edilir.

srcRect parametresi, çizecek image nesnesinin dikdörtgen bir bölümünü belirtir. Bu bölüm ölçeklendirilir ve destPoints parametresi tarafından belirtilen paralelkenarın içine sığacak şekilde yamlanır.

callback ve callbackData parametreleriyle yapılan bu aşırı yükleme, uygulama tarafından belirlenen ölçütlere ve verilere göre bir görüntünün çiziminin durdurulması için araçlar sağlar. Örneğin, bir uygulama büyük bir görüntü çizmeye başlayabilir ve kullanıcı görüntüyü ekrandan kaydırabilir ve bu durumda uygulama çizimi durdurabilir.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, PointF[], RectangleF, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort, Int32)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, cli::array <System::Drawing::PointF> ^ destPoints, System::Drawing::RectangleF srcRect, System::Drawing::GraphicsUnit srcUnit, System::Drawing::Imaging::ImageAttributes ^ imageAttr, System::Drawing::Graphics::DrawImageAbort ^ callback, int callbackData);
public void DrawImage (System.Drawing.Image image, System.Drawing.PointF[] destPoints, System.Drawing.RectangleF srcRect, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes? imageAttr, System.Drawing.Graphics.DrawImageAbort? callback, int callbackData);
public void DrawImage (System.Drawing.Image image, System.Drawing.PointF[] destPoints, System.Drawing.RectangleF srcRect, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes imageAttr, System.Drawing.Graphics.DrawImageAbort callback, int callbackData);
member this.DrawImage : System.Drawing.Image * System.Drawing.PointF[] * System.Drawing.RectangleF * System.Drawing.GraphicsUnit * System.Drawing.Imaging.ImageAttributes * System.Drawing.Graphics.DrawImageAbort * int -> unit
Public Sub DrawImage (image As Image, destPoints As PointF(), srcRect As RectangleF, srcUnit As GraphicsUnit, imageAttr As ImageAttributes, callback As Graphics.DrawImageAbort, callbackData As Integer)

Parametreler

image
Image

Çizmek için Image.

destPoints
PointF[]

Paralelkenar tanımlayan üç PointF yapısı dizisi.

srcRect
RectangleF

Çizecek image nesnesinin bölümünü belirten RectangleF yapı.

srcUnit
GraphicsUnit

srcRect parametresi tarafından kullanılan ölçü birimlerini belirten GraphicsUnit numaralandırmasının üyesi.

imageAttr
ImageAttributes

image nesnesi için yeniden renklendirme ve gama bilgilerini belirten ImageAttributes.

callback
Graphics.DrawImageAbort

görüntünün çizimi sırasında çağrılacak bir yöntem belirten Graphics.DrawImageAbort temsilcisi. Bu yöntem, uygulama tarafından belirlenen ölçütlere göre DrawImage(Image, PointF[], RectangleF, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort, Int32) yönteminin yürütülmesinin durdurulup durdurulmayacağını denetlemek için sık sık çağrılır.

callbackData
Int32

Graphics.DrawImageAbort temsilcisinin DrawImage(Image, PointF[], RectangleF, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort, Int32) yönteminin yürütülmesini durdurup durdurmayacağını denetlerken kullanması gereken ek verileri belirten değer.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği, Windows Forms ile kullanılmak üzere tasarlanmıştır ve PaPaint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod ilk olarak Graphics.DrawImageAbort temsilcisi için bir geri çağırma yöntemi tanımlar; tanımı basittir ve yalnızca DrawImage yönteminin null callBackData parametresiyle çağırıp çağırmadığını test eder. Örneğin ana gövdesi aşağıdaki eylemleri gerçekleştirir:

  • Graphics.DrawImageAbort geri çağırma yönteminin bir örneğini oluşturur.

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Görüntüyü çizmek için bir paralelogram tanımlayan noktalar oluşturur.

  • Resmin çizecek bölümünü seçmek için bir dikdörtgen oluşturur.

  • Grafik çizim birimini piksel olarak ayarlar.

  • Özgün görüntüyü ekrana çizer.

  • Ayarlanmış bir görüntünün çizildiği ek bir paralelogram oluşturur.

  • Düzeltilmiş görüntünün özniteliklerini oluşturur ve her zamankinden daha büyük bir gama değerine sahip olacak şekilde ayarlar.

  • Ayarlanmış görüntüyü ekrana çizer.

Özgün, ayarsız paralel grafik için, konum görüntüyü ekranda bulur ve dikdörtgenin boyutu ile paralel grafiğin boyutu ve şekli, çizilen görüntünün ölçeklendirilip kırpılma durumunu belirler.

Bu örnekte callBackData parametresini geçiren bir aşırı yükleme kullanıldığından, geri çağırma Graphics.DrawImageAbortfalsedöndürür ve bu da DrawImage yönteminin devam etmesine neden olur ve örnek ayarlanan görüntüyü ekrana çizer.

   // Define DrawImageAbort callback method.
private:
   bool DrawImageCallback4( IntPtr callBackData )
   {
      // Test for call that passes callBackData parameter.
      if ( callBackData == IntPtr::Zero )
      {
         // If no callBackData passed, abort DrawImage method.
         return true;
      }
      else
      {
         // If callBackData passed, continue DrawImage method.
         return false;
      }
   }

private:
   void DrawImageParaFRectAttribAbortData( PaintEventArgs^ e )
   {
      // Create callback method.
      Graphics::DrawImageAbort^ imageCallback = gcnew Graphics::DrawImageAbort( this, &Form1::DrawImageCallback4 );
      int imageCallbackData = 1;

      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create parallelogram for drawing original image.
      PointF ulCorner1 = PointF(100.0F,100.0F);
      PointF urCorner1 = PointF(325.0F,100.0F);
      PointF llCorner1 = PointF(150.0F,250.0F);
      array<PointF>^ destPara1 = {ulCorner1,urCorner1,llCorner1};

      // Create rectangle for source image.
      RectangleF srcRect = RectangleF(50.0F,50.0F,150.0F,150.0F);
      GraphicsUnit units = GraphicsUnit::Pixel;

      // Create parallelogram for drawing adjusted image.
      PointF ulCorner2 = PointF(325.0F,100.0F);
      PointF urCorner2 = PointF(550.0F,100.0F);
      PointF llCorner2 = PointF(375.0F,250.0F);
      array<PointF>^ destPara2 = {ulCorner2,urCorner2,llCorner2};

      // Draw original image to screen.
      e->Graphics->DrawImage( newImage, destPara1, srcRect, units );

      // Create image attributes and set large gamma.
      ImageAttributes^ imageAttr = gcnew ImageAttributes;
      imageAttr->SetGamma( 4.0F );
      try
      {
         // Draw adjusted image to screen.
         e->Graphics->DrawImage( newImage, destPara2, srcRect, units, imageAttr, imageCallback, imageCallbackData );
      }
      catch ( Exception^ ex ) 
      {
         e->Graphics->DrawString( ex->ToString(), gcnew System::Drawing::Font( "Arial",8 ), Brushes::Black, PointF(0,0) );
      }
   }

// Define DrawImageAbort callback method.
private bool DrawImageCallback4(IntPtr callBackData)
{
             
    // Test for call that passes callBackData parameter.
    if(callBackData==IntPtr.Zero)
    {
             
        // If no callBackData passed, abort DrawImage method.
        return true;
    }
    else
    {
             
        // If callBackData passed, continue DrawImage method.
        return false;
    }
}
private void DrawImageParaFRectAttribAbortData(PaintEventArgs e)
{
             
    // Create callback method.
    Graphics.DrawImageAbort imageCallback
        = new Graphics.DrawImageAbort(DrawImageCallback4);
    int imageCallbackData = 1;
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create parallelogram for drawing original image.
    PointF ulCorner1 = new PointF(100.0F, 100.0F);
    PointF urCorner1 = new PointF(325.0F, 100.0F);
    PointF llCorner1 = new PointF(150.0F, 250.0F);
    PointF[] destPara1 = {ulCorner1, urCorner1, llCorner1};
             
    // Create rectangle for source image.
    RectangleF srcRect = new RectangleF(50.0F, 50.0F, 150.0F, 150.0F);
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Create parallelogram for drawing adjusted image.
    PointF ulCorner2 = new PointF(325.0F, 100.0F);
    PointF urCorner2 = new PointF(550.0F, 100.0F);
    PointF llCorner2 = new PointF(375.0F, 250.0F);
    PointF[] destPara2 = {ulCorner2, urCorner2, llCorner2};
             
    // Draw original image to screen.
    e.Graphics.DrawImage(newImage, destPara1, srcRect, units);
             
    // Create image attributes and set large gamma.
    ImageAttributes imageAttr = new ImageAttributes();
    imageAttr.SetGamma(4.0F);
    try
    {
        checked
        {
             
            // Draw adjusted image to screen.
            e.Graphics.DrawImage(
                newImage,
                destPara2,
                srcRect,
                units,
                imageAttr,
                imageCallback,
                imageCallbackData);
        }
    }
    catch (Exception ex)
    {
        e.Graphics.DrawString(
            ex.ToString(),
            new Font("Arial", 8),
            Brushes.Black,
            new PointF(0, 0));
    }
}
Private Function DrawImageCallback4(ByVal callBackData As IntPtr) As Boolean

    ' Test for call that passes callBackData parameter.
    If callBackData.Equals(IntPtr.Zero) Then

        ' If no callBackData passed, abort DrawImage method.
        Return True
    Else

        ' If callBackData passed, continue DrawImage method.
        Return False
    End If
End Function
Private Sub DrawImageParaFRectAttribAbortData(ByVal e As PaintEventArgs)

    ' Create callback method.
    Dim imageCallback As New _
    Graphics.DrawImageAbort(AddressOf DrawImageCallback4)
    Dim imageCallbackData As Integer = 1

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create parallelogram for drawing original image.
    Dim ulCorner1 As New PointF(100.0F, 100.0F)
    Dim urCorner1 As New PointF(325.0F, 100.0F)
    Dim llCorner1 As New PointF(150.0F, 250.0F)
    Dim destPara1 As PointF() = {ulCorner1, urCorner1, llCorner1}

    ' Create rectangle for source image.
    Dim srcRect As New RectangleF(50.0F, 50.0F, 150.0F, 150.0F)
    Dim units As GraphicsUnit = GraphicsUnit.Pixel

    ' Create parallelogram for drawing adjusted image.
    Dim ulCorner2 As New PointF(325.0F, 100.0F)
    Dim urCorner2 As New PointF(550.0F, 100.0F)
    Dim llCorner2 As New PointF(375.0F, 250.0F)
    Dim destPara2 As PointF() = {ulCorner2, urCorner2, llCorner2}

    ' Draw original image to screen.
    e.Graphics.DrawImage(newImage, destPara1, srcRect, units)

    ' Create image attributes and set large gamma.
    Dim imageAttr As New ImageAttributes
    imageAttr.SetGamma(4.0F)
    Try

        ' Draw adjusted image to screen.
        e.Graphics.DrawImage(newImage, destPara2, srcRect, units, _
        imageAttr, imageCallback, imageCallbackData)
    Catch ex As Exception
        e.Graphics.DrawString(ex.ToString(), New Font("Arial", 8), _
        Brushes.Black, New PointF(0, 0))
    End Try
End Sub

Açıklamalar

destPoints parametresi paralelkenarın üç noktasını belirtir. Üç PointF yapısı, paralelkenarın sol üst, sağ üst ve sol alt köşelerini temsil eder. Dördüncü nokta, paralelkenar oluşturmak için ilk üç noktadan elde edilir.

srcRect parametresi, çizecek image nesnesinin dikdörtgen bir bölümünü belirtir. Bu bölüm ölçeklendirilir ve destPoints parametresi tarafından belirtilen paralelkenarın içine sığacak şekilde yamlanır.

callback ve callbackData parametreleriyle yapılan bu aşırı yükleme, uygulama tarafından belirlenen ölçütlere ve verilere göre bir görüntünün çiziminin durdurulması için araçlar sağlar. Örneğin, bir uygulama büyük bir görüntü çizmeye başlayabilir ve kullanıcı görüntüyü ekrandan kaydırabilir ve bu durumda uygulama çizimi durdurabilir.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, Rectangle, Int32, Int32, Int32, Int32, GraphicsUnit)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, System::Drawing::Rectangle destRect, int srcX, int srcY, int srcWidth, int srcHeight, System::Drawing::GraphicsUnit srcUnit);
public void DrawImage (System.Drawing.Image image, System.Drawing.Rectangle destRect, int srcX, int srcY, int srcWidth, int srcHeight, System.Drawing.GraphicsUnit srcUnit);
member this.DrawImage : System.Drawing.Image * System.Drawing.Rectangle * int * int * int * int * System.Drawing.GraphicsUnit -> unit
Public Sub DrawImage (image As Image, destRect As Rectangle, srcX As Integer, srcY As Integer, srcWidth As Integer, srcHeight As Integer, srcUnit As GraphicsUnit)

Parametreler

image
Image

Çizmek için Image.

destRect
Rectangle

Çizilen görüntünün konumunu ve boyutunu belirten Rectangle yapısı. Görüntü dikdörtgene sığacak şekilde ölçeklendirilir.

srcX
Int32

Çizecek kaynak görüntünün bölümünün sol üst köşesinin x koordinatı.

srcY
Int32

Çizecek kaynak görüntünün bölümünün sol üst köşesinin y koordinatı.

srcWidth
Int32

Çizecek kaynak görüntünün bölümünün genişliği.

srcHeight
Int32

Çizecek kaynak görüntünün bölümünün yüksekliği.

srcUnit
GraphicsUnit

Kaynak dikdörtgeni belirlemek için kullanılan ölçü birimlerini belirten GraphicsUnit numaralandırmasının üyesi.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Resmin çizildiği hedef dikdörtgeni oluşturur.

  • Görüntünün bir kısmının ayıklandığı kaynak dikdörtgenin koordinatlarını oluşturur.

  • Kaynak dikdörtgenin ölçü birimini piksel olarak ayarlar.

  • Görüntüyü ekrana çizer.

Hedef dikdörtgenin konumu ekrandaki görüntüyü bulur ve kaynak ve hedef dikdörtgenlerin boyutları, çizilen görüntünün ölçeklendirileceğini belirler ve kaynak dikdörtgenin boyutu da özgün görüntünün hangi bölümünün ekrana çizileceğini belirler.

void DrawImageRect4Int( PaintEventArgs^ e )
{
   // Create image.
   Image^ newImage = Image::FromFile( "SampImag.jpg" );

   // Create rectangle for displaying image.
   Rectangle destRect = Rectangle(100,100,450,150);

   // Create coordinates of rectangle for source image.
   int x = 50;
   int y = 50;
   int width = 150;
   int height = 150;
   GraphicsUnit units = GraphicsUnit::Pixel;

   // Draw image to screen.
   e->Graphics->DrawImage( newImage, destRect, x, y, width, height, units );
}
private void DrawImageRect4Int(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create rectangle for displaying image.
    Rectangle destRect = new Rectangle(100, 100, 450, 150);
             
    // Create coordinates of rectangle for source image.
    int x = 50;
    int y = 50;
    int width = 150;
    int height = 150;
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Draw image to screen.
    e.Graphics.DrawImage(newImage, destRect, x, y, width, height, units);
}
Private Sub DrawImageRect4Int(ByVal e As PaintEventArgs)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create rectangle for displaying image.
    Dim destRect As New Rectangle(100, 100, 450, 150)

    ' Create coordinates of rectangle for source image.
    Dim x As Integer = 50
    Dim y As Integer = 50
    Dim width As Integer = 150
    Dim height As Integer = 150
    Dim units As GraphicsUnit = GraphicsUnit.Pixel

    ' Draw image to screen.
    e.Graphics.DrawImage(newImage, destRect, x, y, width, height, _
    units)
End Sub

Açıklamalar

srcX, srcY, srcWidthve srcHeight parametreleri, çizilmesi gereken image nesnesinin dikdörtgen bir bölümünü belirtir. Dikdörtgen, kaynak görüntünün sol üst köşesine göredir. Bu bölüm, destRect parametresi tarafından belirtilen dikdörtgenin içine sığacak şekilde ölçeklendirilir.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, Rectangle, Int32, Int32, Int32, Int32, GraphicsUnit, ImageAttributes)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, System::Drawing::Rectangle destRect, int srcX, int srcY, int srcWidth, int srcHeight, System::Drawing::GraphicsUnit srcUnit, System::Drawing::Imaging::ImageAttributes ^ imageAttr);
public void DrawImage (System.Drawing.Image image, System.Drawing.Rectangle destRect, int srcX, int srcY, int srcWidth, int srcHeight, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes? imageAttr);
public void DrawImage (System.Drawing.Image image, System.Drawing.Rectangle destRect, int srcX, int srcY, int srcWidth, int srcHeight, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes imageAttr);
member this.DrawImage : System.Drawing.Image * System.Drawing.Rectangle * int * int * int * int * System.Drawing.GraphicsUnit * System.Drawing.Imaging.ImageAttributes -> unit
Public Sub DrawImage (image As Image, destRect As Rectangle, srcX As Integer, srcY As Integer, srcWidth As Integer, srcHeight As Integer, srcUnit As GraphicsUnit, imageAttr As ImageAttributes)

Parametreler

image
Image

Çizmek için Image.

destRect
Rectangle

Çizilen görüntünün konumunu ve boyutunu belirten Rectangle yapısı. Görüntü dikdörtgene sığacak şekilde ölçeklendirilir.

srcX
Int32

Çizecek kaynak görüntünün bölümünün sol üst köşesinin x koordinatı.

srcY
Int32

Çizecek kaynak görüntünün bölümünün sol üst köşesinin y koordinatı.

srcWidth
Int32

Çizecek kaynak görüntünün bölümünün genişliği.

srcHeight
Int32

Çizecek kaynak görüntünün bölümünün yüksekliği.

srcUnit
GraphicsUnit

Kaynak dikdörtgeni belirlemek için kullanılan ölçü birimlerini belirten GraphicsUnit numaralandırmasının üyesi.

imageAttr
ImageAttributes

image nesnesi için yeniden renklendirme ve gama bilgilerini belirten ImageAttributes.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Resmin çizildiği hedef dikdörtgeni oluşturur.

  • Görüntünün bir kısmının ayıklandığı kaynak dikdörtgenin koordinatlarını oluşturur.

  • Kaynak dikdörtgenin ölçü birimini piksel olarak ayarlar.

  • Özgün görüntüyü ekrana çizer.

  • Ayarlanmış bir görüntünün çizildiği ek bir dikdörtgen oluşturur.

  • Düzeltilmiş görüntünün özniteliklerini oluşturur ve her zamankinden daha büyük bir gama değerine sahip olacak şekilde ayarlar.

  • Ayarlanmış görüntüyü ekrana çizer.

Özgün, ayarlanmamış hedef dikdörtgen için konum, ekrandaki görüntüyü bulur ve kaynak ve hedef dikdörtgenlerin boyutları, çizilen görüntünün ölçeklendirileceğini belirler ve kaynak dikdörtgenin boyutu, özgün görüntünün hangi bölümünün ekrana çizileceğini belirler.

void DrawImageRect4IntAtrrib( PaintEventArgs^ e )
{
   // Create image.
   Image^ newImage = Image::FromFile( "SampImag.jpg" );

   // Create rectangle for displaying original image.
   Rectangle destRect1 = Rectangle(100,25,450,150);

   // Create coordinates of rectangle for source image.
   int x = 50;
   int y = 50;
   int width = 150;
   int height = 150;
   GraphicsUnit units = GraphicsUnit::Pixel;

   // Draw original image to screen.
   e->Graphics->DrawImage( newImage, destRect1, x, y, width, height, units );

   // Create rectangle for adjusted image.
   Rectangle destRect2 = Rectangle(100,175,450,150);

   // Create image attributes and set large gamma.
   ImageAttributes^ imageAttr = gcnew ImageAttributes;
   imageAttr->SetGamma( 4.0F );

   // Draw adjusted image to screen.
   e->Graphics->DrawImage( newImage, destRect2, x, y, width, height, units, imageAttr );
}
private void DrawImageRect4IntAtrrib(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create rectangle for displaying original image.
    Rectangle destRect1 = new Rectangle(100, 25, 450, 150);
             
    // Create coordinates of rectangle for source image.
    int x = 50;
    int y = 50;
    int width = 150;
    int height = 150;
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Draw original image to screen.
    e.Graphics.DrawImage(newImage, destRect1, x, y, width, height, units);
             
    // Create rectangle for adjusted image.
    Rectangle destRect2 = new Rectangle(100, 175, 450, 150);
             
    // Create image attributes and set large gamma.
    ImageAttributes imageAttr = new ImageAttributes();
    imageAttr.SetGamma(4.0F);
             
    // Draw adjusted image to screen.
    e.Graphics.DrawImage(newImage, destRect2, x, y, width, height, units, imageAttr);
}
Private Sub DrawImageRect4IntAtrrib(ByVal e As PaintEventArgs)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create rectangle for displaying original image.
    Dim destRect1 As New Rectangle(100, 25, 450, 150)

    ' Create coordinates of rectangle for source image.
    Dim x As Integer = 50
    Dim y As Integer = 50
    Dim width As Integer = 150
    Dim height As Integer = 150
    Dim units As GraphicsUnit = GraphicsUnit.Pixel

    ' Draw original image to screen.
    e.Graphics.DrawImage(newImage, destRect1, x, y, width, height, _
    units)

    ' Create rectangle for adjusted image.
    Dim destRect2 As New Rectangle(100, 175, 450, 150)

    ' Create image attributes and set large gamma.
    Dim imageAttr As New ImageAttributes
    imageAttr.SetGamma(4.0F)

    ' Draw adjusted image to screen.
    e.Graphics.DrawImage(newImage, destRect2, x, y, width, height, _
    units, imageAttr)
End Sub

Açıklamalar

srcX, srcY, srcWidthve srcHeight parametreleri, çizilmesi gereken image nesnesinin dikdörtgen bir bölümünü belirtir. Dikdörtgen, kaynak görüntünün sol üst köşesine göredir. Bu bölüm, destRect parametresi tarafından belirtilen dikdörtgenin içine sığacak şekilde ölçeklendirilir.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, Rectangle, Single, Single, Single, Single, GraphicsUnit, ImageAttributes)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, System::Drawing::Rectangle destRect, float srcX, float srcY, float srcWidth, float srcHeight, System::Drawing::GraphicsUnit srcUnit, System::Drawing::Imaging::ImageAttributes ^ imageAttrs);
public void DrawImage (System.Drawing.Image image, System.Drawing.Rectangle destRect, float srcX, float srcY, float srcWidth, float srcHeight, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes? imageAttrs);
public void DrawImage (System.Drawing.Image image, System.Drawing.Rectangle destRect, float srcX, float srcY, float srcWidth, float srcHeight, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes imageAttrs);
member this.DrawImage : System.Drawing.Image * System.Drawing.Rectangle * single * single * single * single * System.Drawing.GraphicsUnit * System.Drawing.Imaging.ImageAttributes -> unit
Public Sub DrawImage (image As Image, destRect As Rectangle, srcX As Single, srcY As Single, srcWidth As Single, srcHeight As Single, srcUnit As GraphicsUnit, imageAttrs As ImageAttributes)

Parametreler

image
Image

Çizmek için Image.

destRect
Rectangle

Çizilen görüntünün konumunu ve boyutunu belirten Rectangle yapısı. Görüntü dikdörtgene sığacak şekilde ölçeklendirilir.

srcX
Single

Çizecek kaynak görüntünün bölümünün sol üst köşesinin x koordinatı.

srcY
Single

Çizecek kaynak görüntünün bölümünün sol üst köşesinin y koordinatı.

srcWidth
Single

Çizecek kaynak görüntünün bölümünün genişliği.

srcHeight
Single

Çizecek kaynak görüntünün bölümünün yüksekliği.

srcUnit
GraphicsUnit

Kaynak dikdörtgeni belirlemek için kullanılan ölçü birimlerini belirten GraphicsUnit numaralandırmasının üyesi.

imageAttrs
ImageAttributes

image nesnesi için yeniden renklendirme ve gama bilgilerini belirten ImageAttributes.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Resmin çizildiği hedef dikdörtgeni oluşturur.

  • Görüntünün bir kısmının ayıklandığı kaynak dikdörtgenin koordinatlarını oluşturur.

  • Kaynak dikdörtgenin ölçü birimini piksel olarak ayarlar.

  • Özgün görüntüyü ekrana çizer.

  • Ayarlanmış bir görüntünün çizildiği ek bir dikdörtgen oluşturur.

  • Düzeltilmiş görüntünün özniteliklerini oluşturur ve her zamankinden daha büyük bir gama değerine sahip olacak şekilde ayarlar.

  • Ayarlanmış görüntüyü ekrana çizer.

Özgün, ayarlanmamış hedef dikdörtgen için konum, ekrandaki görüntüyü bulur ve kaynak ve hedef dikdörtgenlerin boyutları, çizilen görüntünün ölçeklendirileceğini belirler ve kaynak dikdörtgenin boyutu, özgün görüntünün hangi bölümünün ekrana çizileceğini belirler.

private:
   void DrawImageRect4FloatAttrib( PaintEventArgs^ e )
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create rectangle for displaying original image.
      Rectangle destRect1 = Rectangle(100,25,450,150);

      // Create coordinates of rectangle for source image.
      float x = 50.0F;
      float y = 50.0F;
      float width = 150.0F;
      float height = 150.0F;
      GraphicsUnit units = GraphicsUnit::Pixel;

      // Draw original image to screen.
      e->Graphics->DrawImage( newImage, destRect1, x, y, width, height, units );

      // Create rectangle for adjusted image.
      Rectangle destRect2 = Rectangle(100,175,450,150);

      // Create image attributes and set large gamma.
      ImageAttributes^ imageAttr = gcnew ImageAttributes;
      imageAttr->SetGamma( 4.0F );

      // Draw adjusted image to screen.
      e->Graphics->DrawImage( newImage, destRect2, x, y, width, height, units, imageAttr );
   }
private void DrawImageRect4FloatAttrib(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create rectangle for displaying original image.
    Rectangle destRect1 = new Rectangle(100, 25, 450, 150);
             
    // Create coordinates of rectangle for source image.
    float x = 50.0F;
    float y = 50.0F;
    float width = 150.0F;
    float height = 150.0F;
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Draw original image to screen.
    e.Graphics.DrawImage(newImage, destRect1, x, y, width, height, units);
             
    // Create rectangle for adjusted image.
    Rectangle destRect2 = new Rectangle(100, 175, 450, 150);
             
    // Create image attributes and set large gamma.
    ImageAttributes imageAttr = new ImageAttributes();
    imageAttr.SetGamma(4.0F);
             
    // Draw adjusted image to screen.
    e.Graphics.DrawImage(newImage, destRect2, x, y, width, height, units, imageAttr);
}
Private Sub DrawImageRect4FloatAttrib(ByVal e As PaintEventArgs)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create rectangle for displaying original image.
    Dim destRect1 As New Rectangle(100, 25, 450, 150)

    ' Create coordinates of rectangle for source image.
    Dim x As Single = 50.0F
    Dim y As Single = 50.0F
    Dim width As Single = 150.0F
    Dim height As Single = 150.0F
    Dim units As GraphicsUnit = GraphicsUnit.Pixel

    ' Draw original image to screen.
    e.Graphics.DrawImage(newImage, destRect1, x, y, width, _
    height, units)

    ' Create rectangle for adjusted image.
    Dim destRect2 As New Rectangle(100, 175, 450, 150)

    ' Create image attributes and set large gamma.
    Dim imageAttr As New ImageAttributes
    imageAttr.SetGamma(4.0F)

    ' Draw adjusted image to screen.
    e.Graphics.DrawImage(newImage, destRect2, x, y, width, height, _
    units, imageAttr)
End Sub

Açıklamalar

srcX, srcY, srcWidthve srcHeight parametreleri, çizilmesi gereken image nesnesinin dikdörtgen bir bölümünü belirtir. Dikdörtgen, kaynak görüntünün sol üst köşesine göredir. Bu bölüm, destRect parametresi tarafından belirtilen dikdörtgenin içine sığacak şekilde ölçeklendirilir.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, Rectangle, Int32, Int32, Int32, Int32, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, System::Drawing::Rectangle destRect, int srcX, int srcY, int srcWidth, int srcHeight, System::Drawing::GraphicsUnit srcUnit, System::Drawing::Imaging::ImageAttributes ^ imageAttr, System::Drawing::Graphics::DrawImageAbort ^ callback);
public void DrawImage (System.Drawing.Image image, System.Drawing.Rectangle destRect, int srcX, int srcY, int srcWidth, int srcHeight, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes? imageAttr, System.Drawing.Graphics.DrawImageAbort? callback);
public void DrawImage (System.Drawing.Image image, System.Drawing.Rectangle destRect, int srcX, int srcY, int srcWidth, int srcHeight, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes imageAttr, System.Drawing.Graphics.DrawImageAbort callback);
member this.DrawImage : System.Drawing.Image * System.Drawing.Rectangle * int * int * int * int * System.Drawing.GraphicsUnit * System.Drawing.Imaging.ImageAttributes * System.Drawing.Graphics.DrawImageAbort -> unit
Public Sub DrawImage (image As Image, destRect As Rectangle, srcX As Integer, srcY As Integer, srcWidth As Integer, srcHeight As Integer, srcUnit As GraphicsUnit, imageAttr As ImageAttributes, callback As Graphics.DrawImageAbort)

Parametreler

image
Image

Çizmek için Image.

destRect
Rectangle

Çizilen görüntünün konumunu ve boyutunu belirten Rectangle yapısı. Görüntü dikdörtgene sığacak şekilde ölçeklendirilir.

srcX
Int32

Çizecek kaynak görüntünün bölümünün sol üst köşesinin x koordinatı.

srcY
Int32

Çizecek kaynak görüntünün bölümünün sol üst köşesinin y koordinatı.

srcWidth
Int32

Çizecek kaynak görüntünün bölümünün genişliği.

srcHeight
Int32

Çizecek kaynak görüntünün bölümünün yüksekliği.

srcUnit
GraphicsUnit

Kaynak dikdörtgeni belirlemek için kullanılan ölçü birimlerini belirten GraphicsUnit numaralandırmasının üyesi.

imageAttr
ImageAttributes

imageiçin yeniden renklendirme ve gama bilgilerini belirten ImageAttributes.

callback
Graphics.DrawImageAbort

görüntünün çizimi sırasında çağrılacak bir yöntem belirten Graphics.DrawImageAbort temsilcisi. Bu yöntem, uygulama tarafından belirlenen ölçütlere göre DrawImage(Image, Rectangle, Int32, Int32, Int32, Int32, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort) yönteminin yürütülmesinin durdurulup durdurulmayacağını denetlemek için sık sık çağrılır.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod ilk olarak Graphics.DrawImageAbort temsilcisi için bir geri çağırma yöntemi tanımlar; tanımı basittir ve yalnızca DrawImage yönteminin null callBackData parametresiyle çağırıp çağırmadığını test eder. Örneğin ana gövdesi aşağıdaki eylemleri gerçekleştirir:

  • Graphics.DrawImageAbort geri çağırma yönteminin bir örneğini oluşturur.

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Görüntünün çizildiği hedef dikdörtgeni tanımlayan noktalar oluşturur.

  • Resmin çizecek bölümünü seçmek için bir kaynak dikdörtgen oluşturur.

  • Grafik çizim birimini piksel olarak ayarlar.

  • Özgün görüntüyü ekrana çizer.

  • Ayarlanmış bir görüntü çizilecek ek bir hedef dikdörtgen oluşturur.

  • Düzeltilmiş görüntünün özniteliklerini oluşturur ve her zamankinden daha büyük bir gama değerine sahip olacak şekilde ayarlar.

  • Ayarlanmış görüntüyü ekrana çizer.

Özgün, ayarsız hedef dikdörtgen için konum görüntüyü ekranda bulur ve kaynak dikdörtgenin boyutu ile hedef dikdörtgenin boyutu ve şekli, çizilen görüntünün ölçeklendirilme şeklini belirler.

Bu örnekte callBackData parametresi geçirmeyen bir aşırı yükleme kullanıldığından, geri çağırma Graphics.DrawImageAborttruedöndürür. Bu da DrawImage yönteminin sona ermesini sağlar ve örnekte yer alan özel durum işleme kodu görüntüyü çizmek yerine özel durum metnini yazdırır.

   // Define DrawImageAbort callback method.
private:
   bool DrawImageCallback5( IntPtr callBackData )
   {
      // Test for call that passes callBackData parameter.
      if ( callBackData == IntPtr::Zero )
      {
         // If no callBackData passed, abort DrawImage method.
         return true;
      }
      else
      {
         // If callBackData passed, continue DrawImage method.
         return false;
      }
   }

private:
   void DrawImageRect4IntAtrribAbort( PaintEventArgs^ e )
   {
      // Create callback method.
      Graphics::DrawImageAbort^ imageCallback = gcnew Graphics::DrawImageAbort( this, &Form1::DrawImageCallback5 );

      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create rectangle for displaying original image.
      Rectangle destRect1 = Rectangle(100,25,450,150);

      // Create coordinates of rectangle for source image.
      int x = 50;
      int y = 50;
      int width = 150;
      int height = 150;
      GraphicsUnit units = GraphicsUnit::Pixel;

      // Draw original image to screen.
      e->Graphics->DrawImage( newImage, destRect1, x, y, width, height, units );

      // Create rectangle for adjusted image.
      Rectangle destRect2 = Rectangle(100,175,450,150);

      // Create image attributes and set large gamma.
      ImageAttributes^ imageAttr = gcnew ImageAttributes;
      imageAttr->SetGamma( 4.0F );
      try
      {
         // Draw adjusted image to screen.
         e->Graphics->DrawImage( newImage, destRect2, x, y, width, height, units, imageAttr, imageCallback );
      }
      catch ( Exception^ ex ) 
      {
         e->Graphics->DrawString( ex->ToString(), gcnew System::Drawing::Font( "Arial",8 ), Brushes::Black, PointF(0,0) );
      }
   }

// Define DrawImageAbort callback method.
private bool DrawImageCallback5(IntPtr callBackData)
{
             
    // Test for call that passes callBackData parameter.
    if(callBackData==IntPtr.Zero)
    {
             
        // If no callBackData passed, abort DrawImage method.
        return true;
    }
    else
    {
             
        // If callBackData passed, continue DrawImage method.
        return false;
    }
}
private void DrawImageRect4IntAtrribAbort(PaintEventArgs e)
{
             
    // Create callback method.
    Graphics.DrawImageAbort imageCallback
        = new Graphics.DrawImageAbort(DrawImageCallback5);
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create rectangle for displaying original image.
    Rectangle destRect1 = new Rectangle(100, 25, 450, 150);
             
    // Create coordinates of rectangle for source image.
    int x = 50;
    int y = 50;
    int width = 150;
    int height = 150;
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Draw original image to screen.
    e.Graphics.DrawImage(newImage, destRect1, x, y, width, height, units);
             
    // Create rectangle for adjusted image.
    Rectangle destRect2 = new Rectangle(100, 175, 450, 150);
             
    // Create image attributes and set large gamma.
    ImageAttributes imageAttr = new ImageAttributes();
    imageAttr.SetGamma(4.0F);
    try
    {
        checked
        {
             
            // Draw adjusted image to screen.
            e.Graphics.DrawImage(
                newImage,
                destRect2,
                x, y,
                width, height,
                units,
                imageAttr,
                imageCallback);
        }
    }
    catch (Exception ex)
    {
        e.Graphics.DrawString(
            ex.ToString(),
            new Font("Arial", 8),
            Brushes.Black,
            new PointF(0, 0));
    }
}
Private Function DrawImageCallback5(ByVal callBackData As IntPtr) As Boolean

    ' Test for call that passes callBackData parameter.
    If callBackData.Equals(IntPtr.Zero) Then

        ' If no callBackData passed, abort DrawImage method.
        Return True
    Else

        ' If callBackData passed, continue DrawImage method.
        Return False
    End If
End Function
Private Sub DrawImageRect4IntAtrribAbort(ByVal e As PaintEventArgs)

    ' Create callback method.
    Dim imageCallback As New _
    Graphics.DrawImageAbort(AddressOf DrawImageCallback5)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create rectangle for displaying original image.
    Dim destRect1 As New Rectangle(100, 25, 450, 150)

    ' Create coordinates of rectangle for source image.
    Dim x As Integer = 50
    Dim y As Integer = 50
    Dim width As Integer = 150
    Dim height As Integer = 150
    Dim units As GraphicsUnit = GraphicsUnit.Pixel

    ' Draw original image to screen.
    e.Graphics.DrawImage(newImage, destRect1, x, y, width, height, _
    units)

    ' Create rectangle for adjusted image.
    Dim destRect2 As New Rectangle(100, 175, 450, 150)

    ' Create image attributes and set large gamma.
    Dim imageAttr As New ImageAttributes
    imageAttr.SetGamma(4.0F)
    Try

        ' Draw adjusted image to screen.
        e.Graphics.DrawImage(newImage, destRect2, x, y, width, _
        height, units, imageAttr, imageCallback)
    Catch ex As Exception
        e.Graphics.DrawString(ex.ToString(), New Font("Arial", 8), _
        Brushes.Black, New PointF(0, 0))
    End Try
End Sub

Açıklamalar

srcX, srcY, srcWidthve srcHeight parametreleri, çizilmesi gereken image nesnesinin dikdörtgen bir bölümünü belirtir. Dikdörtgen, kaynak görüntünün sol üst köşesine göredir. Bu bölüm, destRect nesnesi tarafından belirtilen dikdörtgenin içine sığacak şekilde ölçeklendirilir.

callback parametresiyle yapılan bu aşırı yükleme, uygulama tarafından belirlenen ölçütlere göre başladıktan sonra görüntünün çizimini durdurma araçları sağlar. Örneğin, bir uygulama büyük bir görüntü çizmeye başlayabilir ve kullanıcı görüntüyü ekrandan kaydırabilir ve bu durumda uygulama çizimi durdurabilir.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, Rectangle, Single, Single, Single, Single, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, System::Drawing::Rectangle destRect, float srcX, float srcY, float srcWidth, float srcHeight, System::Drawing::GraphicsUnit srcUnit, System::Drawing::Imaging::ImageAttributes ^ imageAttrs, System::Drawing::Graphics::DrawImageAbort ^ callback);
public void DrawImage (System.Drawing.Image image, System.Drawing.Rectangle destRect, float srcX, float srcY, float srcWidth, float srcHeight, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes? imageAttrs, System.Drawing.Graphics.DrawImageAbort? callback);
public void DrawImage (System.Drawing.Image image, System.Drawing.Rectangle destRect, float srcX, float srcY, float srcWidth, float srcHeight, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes imageAttrs, System.Drawing.Graphics.DrawImageAbort callback);
member this.DrawImage : System.Drawing.Image * System.Drawing.Rectangle * single * single * single * single * System.Drawing.GraphicsUnit * System.Drawing.Imaging.ImageAttributes * System.Drawing.Graphics.DrawImageAbort -> unit
Public Sub DrawImage (image As Image, destRect As Rectangle, srcX As Single, srcY As Single, srcWidth As Single, srcHeight As Single, srcUnit As GraphicsUnit, imageAttrs As ImageAttributes, callback As Graphics.DrawImageAbort)

Parametreler

image
Image

Çizmek için Image.

destRect
Rectangle

Çizilen görüntünün konumunu ve boyutunu belirten Rectangle yapısı. Görüntü dikdörtgene sığacak şekilde ölçeklendirilir.

srcX
Single

Çizecek kaynak görüntünün bölümünün sol üst köşesinin x koordinatı.

srcY
Single

Çizecek kaynak görüntünün bölümünün sol üst köşesinin y koordinatı.

srcWidth
Single

Çizecek kaynak görüntünün bölümünün genişliği.

srcHeight
Single

Çizecek kaynak görüntünün bölümünün yüksekliği.

srcUnit
GraphicsUnit

Kaynak dikdörtgeni belirlemek için kullanılan ölçü birimlerini belirten GraphicsUnit numaralandırmasının üyesi.

imageAttrs
ImageAttributes

image nesnesi için yeniden renklendirme ve gama bilgilerini belirten ImageAttributes.

callback
Graphics.DrawImageAbort

görüntünün çizimi sırasında çağrılacak bir yöntem belirten Graphics.DrawImageAbort temsilcisi. Bu yöntem, uygulama tarafından belirlenen ölçütlere göre DrawImage(Image, Rectangle, Single, Single, Single, Single, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort) yönteminin yürütülmesinin durdurulup durdurulmayacağını denetlemek için sık sık çağrılır.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod ilk olarak Graphics.DrawImageAbort temsilcisi için bir geri çağırma yöntemi tanımlar; tanımı basittir ve yalnızca DrawImage yönteminin null callBackData parametresiyle çağırıp çağırmadığını test eder. Örneğin ana gövdesi aşağıdaki eylemleri gerçekleştirir:

  • Graphics.DrawImageAbort geri çağırma yönteminin bir örneğini oluşturur.

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Görüntünün çizildiği hedef dikdörtgeni tanımlayan noktalar oluşturur.

  • Resmin çizecek bölümünü seçmek için bir kaynak dikdörtgen oluşturur.

  • Grafik çizim birimini piksel olarak ayarlar.

  • Özgün görüntüyü ekrana çizer.

  • Ayarlanmış bir görüntü çizilecek ek bir hedef dikdörtgen oluşturur.

  • Düzeltilmiş görüntünün özniteliklerini oluşturur ve her zamankinden daha büyük bir gama değerine sahip olacak şekilde ayarlar.

  • Ayarlanmış görüntüyü ekrana çizer.

Özgün, ayarsız hedef dikdörtgen için konum görüntüyü ekranda bulur ve kaynak dikdörtgenin boyutu ile hedef dikdörtgenin boyutu ve şekli, çizilen görüntünün ölçeklendirilme şeklini belirler.

Bu örnekte callBackData parametresi geçirmeyen bir aşırı yükleme kullanıldığından, geri çağırma Graphics.DrawImageAborttruedöndürür. Bu da DrawImage yönteminin sona ermesini sağlar ve örnekte yer alan özel durum işleme kodu görüntüyü çizmek yerine özel durum metnini yazdırır.

   // Define DrawImageAbort callback method.
private:
   bool DrawImageCallback7( IntPtr callBackData )
   {
      // Test for call that passes callBackData parameter.
      if ( callBackData == IntPtr::Zero )
      {
         // If no callBackData passed, abort DrawImage method.
         return true;
      }
      else
      {
         // If callBackData passed, continue DrawImage method.
         return false;
      }
   }

private:
   void DrawImageRect4FloatAttribAbort( PaintEventArgs^ e )
   {
      // Create callback method.
      Graphics::DrawImageAbort^ imageCallback = gcnew Graphics::DrawImageAbort( this, &Form1::DrawImageCallback7 );

      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create rectangle for displaying original image.
      Rectangle destRect1 = Rectangle(100,25,450,150);

      // Create coordinates of rectangle for source image.
      float x = 50.0F;
      float y = 50.0F;
      float width = 150.0F;
      float height = 150.0F;
      GraphicsUnit units = GraphicsUnit::Pixel;

      // Draw original image to screen.
      e->Graphics->DrawImage( newImage, destRect1, x, y, width, height, units );

      // Create rectangle for adjusted image.
      Rectangle destRect2 = Rectangle(100,175,450,150);

      // Create image attributes and set large gamma.
      ImageAttributes^ imageAttr = gcnew ImageAttributes;
      imageAttr->SetGamma( 4.0F );
      try
      {
         // Draw adjusted image to screen.
         e->Graphics->DrawImage( newImage, destRect2, x, y, width, height, units, imageAttr, imageCallback );
      }
      catch ( Exception^ ex ) 
      {
         e->Graphics->DrawString( ex->ToString(), gcnew System::Drawing::Font( "Arial",8 ), Brushes::Black, PointF(0,0) );
      }
   }

// Define DrawImageAbort callback method.
private bool DrawImageCallback7(IntPtr callBackData)
{
             
    // Test for call that passes callBackData parameter.
    if(callBackData==IntPtr.Zero)
    {
             
        // If no callBackData passed, abort DrawImage method.
        return true;
    }
    else
    {
             
        // If callBackData passed, continue DrawImage method.
        return false;
    }
}
private void DrawImageRect4FloatAttribAbort(PaintEventArgs e)
{
             
    // Create callback method.
    Graphics.DrawImageAbort imageCallback
        = new Graphics.DrawImageAbort(DrawImageCallback7);
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create rectangle for displaying original image.
    Rectangle destRect1 = new Rectangle(100, 25, 450, 150);
             
    // Create coordinates of rectangle for source image.
    float x = 50.0F;
    float y = 50.0F;
    float width = 150.0F;
    float height = 150.0F;
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Draw original image to screen.
    e.Graphics.DrawImage(newImage, destRect1, x, y, width, height, units);
             
    // Create rectangle for adjusted image.
    Rectangle destRect2 = new Rectangle(100, 175, 450, 150);
             
    // Create image attributes and set large gamma.
    ImageAttributes imageAttr = new ImageAttributes();
    imageAttr.SetGamma(4.0F);
    try
    {
        checked
        {
             
            // Draw adjusted image to screen.
            e.Graphics.DrawImage(
                newImage,
                destRect2,
                x, y,
                width, height,
                units,
                imageAttr,
                imageCallback);
        }
    }
    catch (Exception ex)
    {
        e.Graphics.DrawString(
            ex.ToString(),
            new Font("Arial", 8),
            Brushes.Black,
            new PointF(0, 0));
    }
}
Private Function DrawImageCallback7(ByVal callBackData As IntPtr) As Boolean

    ' Test for call that passes callBackData parameter.
    If callBackData.Equals(IntPtr.Zero) Then

        ' If no callBackData passed, abort DrawImage method.
        Return True
    Else

        ' If callBackData passed, continue DrawImage method.
        Return False
    End If
End Function
Private Sub DrawImageRect4FloatAttribAbort(ByVal e As PaintEventArgs)

    ' Create callback method.
    Dim imageCallback As New _
    Graphics.DrawImageAbort(AddressOf DrawImageCallback7)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create rectangle for displaying original image.
    Dim destRect1 As New Rectangle(100, 25, 450, 150)

    ' Create coordinates of rectangle for source image.
    Dim x As Single = 50.0F
    Dim y As Single = 50.0F
    Dim width As Single = 150.0F
    Dim height As Single = 150.0F
    Dim units As GraphicsUnit = GraphicsUnit.Pixel

    ' Draw original image to screen.
    e.Graphics.DrawImage(newImage, destRect1, x, y, width, _
    height, units)

    ' Create rectangle for adjusted image.
    Dim destRect2 As New Rectangle(100, 175, 450, 150)

    ' Create image attributes and set large gamma.
    Dim imageAttr As New ImageAttributes
    imageAttr.SetGamma(4.0F)
    Try

        ' Draw adjusted image to screen.
        e.Graphics.DrawImage(newImage, destRect2, x, y, width, _
        height, units, imageAttr, imageCallback)
    Catch ex As Exception
        e.Graphics.DrawString(ex.ToString(), New Font("Arial", 8), _
        Brushes.Black, New PointF(0, 0))
    End Try
End Sub

Açıklamalar

srcX, srcY, srcWidthve srcHeight parametreleri, çizilmesi gereken image nesnesinin dikdörtgen bir bölümünü belirtir. Dikdörtgen, kaynak görüntünün sol üst köşesine göredir. Bu bölüm, destRect parametresi tarafından belirtilen dikdörtgenin içine sığacak şekilde ölçeklendirilir.

callback parametresiyle yapılan bu aşırı yükleme, uygulama tarafından belirlenen ölçütlere göre başladıktan sonra görüntünün çizimini durdurma araçları sağlar. Örneğin, bir uygulama büyük bir görüntü çizmeye başlayabilir ve kullanıcı görüntüyü ekrandan kaydırabilir ve bu durumda uygulama çizimi durdurabilir.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, Rectangle, Int32, Int32, Int32, Int32, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort, IntPtr)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, System::Drawing::Rectangle destRect, int srcX, int srcY, int srcWidth, int srcHeight, System::Drawing::GraphicsUnit srcUnit, System::Drawing::Imaging::ImageAttributes ^ imageAttrs, System::Drawing::Graphics::DrawImageAbort ^ callback, IntPtr callbackData);
public void DrawImage (System.Drawing.Image image, System.Drawing.Rectangle destRect, int srcX, int srcY, int srcWidth, int srcHeight, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes? imageAttrs, System.Drawing.Graphics.DrawImageAbort? callback, IntPtr callbackData);
public void DrawImage (System.Drawing.Image image, System.Drawing.Rectangle destRect, int srcX, int srcY, int srcWidth, int srcHeight, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes imageAttrs, System.Drawing.Graphics.DrawImageAbort callback, IntPtr callbackData);
member this.DrawImage : System.Drawing.Image * System.Drawing.Rectangle * int * int * int * int * System.Drawing.GraphicsUnit * System.Drawing.Imaging.ImageAttributes * System.Drawing.Graphics.DrawImageAbort * nativeint -> unit
Public Sub DrawImage (image As Image, destRect As Rectangle, srcX As Integer, srcY As Integer, srcWidth As Integer, srcHeight As Integer, srcUnit As GraphicsUnit, imageAttrs As ImageAttributes, callback As Graphics.DrawImageAbort, callbackData As IntPtr)

Parametreler

image
Image

Çizmek için Image.

destRect
Rectangle

Çizilen görüntünün konumunu ve boyutunu belirten Rectangle yapısı. Görüntü dikdörtgene sığacak şekilde ölçeklendirilir.

srcX
Int32

Çizecek kaynak görüntünün bölümünün sol üst köşesinin x koordinatı.

srcY
Int32

Çizecek kaynak görüntünün bölümünün sol üst köşesinin y koordinatı.

srcWidth
Int32

Çizecek kaynak görüntünün bölümünün genişliği.

srcHeight
Int32

Çizecek kaynak görüntünün bölümünün yüksekliği.

srcUnit
GraphicsUnit

Kaynak dikdörtgeni belirlemek için kullanılan ölçü birimlerini belirten GraphicsUnit numaralandırmasının üyesi.

imageAttrs
ImageAttributes

image nesnesi için yeniden renklendirme ve gama bilgilerini belirten ImageAttributes.

callback
Graphics.DrawImageAbort

görüntünün çizimi sırasında çağrılacak bir yöntem belirten Graphics.DrawImageAbort temsilcisi. Bu yöntem, uygulama tarafından belirlenen ölçütlere göre DrawImage(Image, Rectangle, Int32, Int32, Int32, Int32, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort, IntPtr) yönteminin yürütülmesinin durdurulup durdurulmayacağını denetlemek için sık sık çağrılır.

callbackData
IntPtr

nativeint

Graphics.DrawImageAbort temsilcisinin DrawImage yönteminin yürütülmesini durdurup durdurmayacağını denetlerken kullanması gereken ek verileri belirten değer.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod ilk olarak Graphics.DrawImageAbort temsilcisi için bir geri çağırma yöntemi tanımlar; tanımı basittir ve yalnızca DrawImage yönteminin null callBackData parametresiyle çağırıp çağırmadığını test eder. Örneğin ana gövdesi aşağıdaki eylemleri gerçekleştirir:

  • Graphics.DrawImageAbort geri çağırma yönteminin bir örneğini oluşturur.

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Görüntünün çizildiği hedef dikdörtgeni tanımlayan noktalar oluşturur.

  • Resmin çizecek bölümünü seçmek için bir kaynak dikdörtgen oluşturur.

  • Grafik çizim birimini piksel olarak ayarlar.

  • Özgün görüntüyü ekrana çizer.

  • Ayarlanmış bir görüntü çizilecek ek bir hedef dikdörtgen oluşturur.

  • Düzeltilmiş görüntünün özniteliklerini oluşturur ve her zamankinden daha büyük bir gama değerine sahip olacak şekilde ayarlar.

  • Ayarlanmış görüntüyü ekrana çizer.

Özgün, ayarsız hedef dikdörtgen için konum görüntüyü ekranda bulur ve kaynak dikdörtgenin boyutu ile hedef dikdörtgenin boyutu ve şekli, çizilen görüntünün ölçeklendirilme şeklini belirler.

Bu örnekte callBackData parametresini geçiren bir aşırı yükleme kullanıldığından, geri çağırma Graphics.DrawImageAbortfalsedöndürür ve bu da DrawImage yönteminin devam etmesine neden olur ve örnek ayarlanan görüntüyü ekrana çizer.

   // Define DrawImageAbort callback method.
private:
   bool DrawImageCallback6( IntPtr callBackData )
   {
      // Test for call that passes callBackData parameter.
      if ( callBackData == IntPtr::Zero )
      {
         // If no callBackData passed, abort DrawImage method.
         return true;
      }
      else
      {
         // If callBackData passed, continue DrawImage method.
         return false;
      }
   }

private:
   void DrawImageRect4IntAtrribAbortData( PaintEventArgs^ e )
   {
      // Create callback method.
      Graphics::DrawImageAbort^ imageCallback = gcnew Graphics::DrawImageAbort( this, &Form1::DrawImageCallback6 );
      IntPtr imageCallbackData = IntPtr(1);

      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create rectangle for displaying original image.
      Rectangle destRect1 = Rectangle(100,25,450,150);

      // Create coordinates of rectangle for source image.
      int x = 50;
      int y = 50;
      int width = 150;
      int height = 150;
      GraphicsUnit units = GraphicsUnit::Pixel;

      // Draw original image to screen.
      e->Graphics->DrawImage( newImage, destRect1, x, y, width, height, units );

      // Create rectangle for adjusted image.
      Rectangle destRect2 = Rectangle(100,175,450,150);

      // Create image attributes and set large gamma.
      ImageAttributes^ imageAttr = gcnew ImageAttributes;
      imageAttr->SetGamma( 4.0F );
      try
      {
         // Draw adjusted image to screen.
         e->Graphics->DrawImage( newImage, destRect2, x, y, width, height, units, imageAttr, imageCallback, imageCallbackData );
      }
      catch ( Exception^ ex ) 
      {
         e->Graphics->DrawString( ex->ToString(), gcnew System::Drawing::Font( "Arial",8 ), Brushes::Black, PointF(0,0) );
      }
   }

// Define DrawImageAbort callback method.
private bool DrawImageCallback6(IntPtr callBackData)
{
             
    // Test for call that passes callBackData parameter.
    if(callBackData==IntPtr.Zero)
    {
             
        // If no callBackData passed, abort DrawImage method.
        return true;
    }
    else
    {
             
        // If callBackData passed, continue DrawImage method.
        return false;
    }
}
private void DrawImageRect4IntAtrribAbortData(PaintEventArgs e)
{
             
    // Create callback method.
    Graphics.DrawImageAbort imageCallback
        = new Graphics.DrawImageAbort(DrawImageCallback6);
    IntPtr imageCallbackData = new IntPtr(1);
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create rectangle for displaying original image.
    Rectangle destRect1 = new Rectangle(100, 25, 450, 150);
             
    // Create coordinates of rectangle for source image.
    int x = 50;
    int y = 50;
    int width = 150;
    int height = 150;
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Draw original image to screen.
    e.Graphics.DrawImage(newImage, destRect1, x, y, width, height, units);
             
    // Create rectangle for adjusted image.
    Rectangle destRect2 = new Rectangle(100, 175, 450, 150);
             
    // Create image attributes and set large gamma.
    ImageAttributes imageAttr = new ImageAttributes();
    imageAttr.SetGamma(4.0F);
    try
    {
        checked
        {
             
            // Draw adjusted image to screen.
            e.Graphics.DrawImage(
                newImage,
                destRect2,
                x, y,
                width, height,
                units,
                imageAttr,
                imageCallback,
                imageCallbackData);
        }
    }
    catch (Exception ex)
    {
        e.Graphics.DrawString(
            ex.ToString(),
            new Font("Arial", 8),
            Brushes.Black,
            new PointF(0, 0));
    }
}
Private Function DrawImageCallback6(ByVal callBackData As IntPtr) As Boolean

    ' Test for call that passes callBackData parameter.
    If callBackData.Equals(IntPtr.Zero) Then

        ' If no callBackData passed, abort DrawImage method.
        Return True
    Else

        ' If callBackData passed, continue DrawImage method.
        Return False
    End If
End Function
Private Sub DrawImageRect4IntAtrribAbortData(ByVal e As PaintEventArgs)

    ' Create callback method.
    Dim imageCallback As New _
    Graphics.DrawImageAbort(AddressOf DrawImageCallback6)
    Dim imageCallbackData As New IntPtr(1)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create rectangle for displaying original image.
    Dim destRect1 As New Rectangle(100, 25, 450, 150)

    ' Create coordinates of rectangle for source image.
    Dim x As Integer = 50
    Dim y As Integer = 50
    Dim width As Integer = 150
    Dim height As Integer = 150
    Dim units As GraphicsUnit = GraphicsUnit.Pixel

    ' Draw original image to screen.
    e.Graphics.DrawImage(newImage, destRect1, x, y, width, height, _
    units)

    ' Create rectangle for adjusted image.
    Dim destRect2 As New Rectangle(100, 175, 450, 150)

    ' Create image attributes and set large gamma.
    Dim imageAttr As New ImageAttributes
    imageAttr.SetGamma(4.0F)
    Try

        ' Draw adjusted image to screen.
        e.Graphics.DrawImage(newImage, destRect2, x, y, width, _
        height, units, imageAttr, imageCallback, imageCallbackData)
    Catch ex As Exception
        e.Graphics.DrawString(ex.ToString(), New Font("Arial", 8), _
        Brushes.Black, New PointF(0, 0))
    End Try
End Sub

Açıklamalar

srcX, srcY, srcWidthve srcHeight parametreleri, çizilmesi gereken image nesnesinin dikdörtgen bir bölümünü belirtir. Dikdörtgen, kaynak görüntünün sol üst köşesine göredir. Bu bölüm, destRect parametresi tarafından belirtilen dikdörtgenin içine sığacak şekilde ölçeklendirilir.

callback ve callbackData parametreleriyle yapılan bu aşırı yükleme, uygulama tarafından belirlenen ölçütlere ve verilere göre bir görüntünün çiziminin durdurulması için araçlar sağlar. Örneğin, bir uygulama büyük bir görüntü çizmeye başlayabilir ve kullanıcı görüntüyü ekrandan kaydırabilir ve bu durumda uygulama çizimi durdurabilir.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, Rectangle, Single, Single, Single, Single, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort, IntPtr)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, System::Drawing::Rectangle destRect, float srcX, float srcY, float srcWidth, float srcHeight, System::Drawing::GraphicsUnit srcUnit, System::Drawing::Imaging::ImageAttributes ^ imageAttrs, System::Drawing::Graphics::DrawImageAbort ^ callback, IntPtr callbackData);
public void DrawImage (System.Drawing.Image image, System.Drawing.Rectangle destRect, float srcX, float srcY, float srcWidth, float srcHeight, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes? imageAttrs, System.Drawing.Graphics.DrawImageAbort? callback, IntPtr callbackData);
public void DrawImage (System.Drawing.Image image, System.Drawing.Rectangle destRect, float srcX, float srcY, float srcWidth, float srcHeight, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes imageAttrs, System.Drawing.Graphics.DrawImageAbort callback, IntPtr callbackData);
member this.DrawImage : System.Drawing.Image * System.Drawing.Rectangle * single * single * single * single * System.Drawing.GraphicsUnit * System.Drawing.Imaging.ImageAttributes * System.Drawing.Graphics.DrawImageAbort * nativeint -> unit
Public Sub DrawImage (image As Image, destRect As Rectangle, srcX As Single, srcY As Single, srcWidth As Single, srcHeight As Single, srcUnit As GraphicsUnit, imageAttrs As ImageAttributes, callback As Graphics.DrawImageAbort, callbackData As IntPtr)

Parametreler

image
Image

Çizmek için Image.

destRect
Rectangle

Çizilen görüntünün konumunu ve boyutunu belirten Rectangle yapısı. Görüntü dikdörtgene sığacak şekilde ölçeklendirilir.

srcX
Single

Çizecek kaynak görüntünün bölümünün sol üst köşesinin x koordinatı.

srcY
Single

Çizecek kaynak görüntünün bölümünün sol üst köşesinin y koordinatı.

srcWidth
Single

Çizecek kaynak görüntünün bölümünün genişliği.

srcHeight
Single

Çizecek kaynak görüntünün bölümünün yüksekliği.

srcUnit
GraphicsUnit

Kaynak dikdörtgeni belirlemek için kullanılan ölçü birimlerini belirten GraphicsUnit numaralandırmasının üyesi.

imageAttrs
ImageAttributes

image nesnesi için yeniden renklendirme ve gama bilgilerini belirten ImageAttributes.

callback
Graphics.DrawImageAbort

görüntünün çizimi sırasında çağrılacak bir yöntem belirten Graphics.DrawImageAbort temsilcisi. Bu yöntem, uygulama tarafından belirlenen ölçütlere göre DrawImage(Image, Rectangle, Single, Single, Single, Single, GraphicsUnit, ImageAttributes, Graphics+DrawImageAbort, IntPtr) yönteminin yürütülmesinin durdurulup durdurulmayacağını denetlemek için sık sık çağrılır.

callbackData
IntPtr

nativeint

Graphics.DrawImageAbort temsilcisinin DrawImage yönteminin yürütülmesini durdurup durdurmayacağını denetlerken kullanması gereken ek verileri belirten değer.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod ilk olarak Graphics.DrawImageAbort temsilcisi için bir geri çağırma yöntemi tanımlar; tanımı basittir ve yalnızca DrawImage yönteminin null callBackData parametresiyle çağırıp çağırmadığını test eder. Örneğin ana gövdesi aşağıdaki eylemleri gerçekleştirir:

  • Graphics.DrawImageAbort geri çağırma yönteminin bir örneğini oluşturur.

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Görüntünün çizildiği hedef dikdörtgeni tanımlayan noktalar oluşturur.

  • Resmin çizecek bölümünü seçmek için bir kaynak dikdörtgen oluşturur.

  • Grafik çizim birimini piksel olarak ayarlar.

  • Özgün görüntüyü ekrana çizer.

  • Ayarlanmış bir görüntü çizilecek ek bir hedef dikdörtgen oluşturur.

  • Düzeltilmiş görüntünün özniteliklerini oluşturur ve her zamankinden daha büyük bir gama değerine sahip olacak şekilde ayarlar.

  • Ayarlanmış görüntüyü ekrana çizer.

Özgün, ayarsız hedef dikdörtgen için konum görüntüyü ekranda bulur ve kaynak dikdörtgenin boyutu ile hedef dikdörtgenin boyutu ve şekli, çizilen görüntünün ölçeklendirilme şeklini belirler.

Bu örnekte callBackData parametresini geçiren bir aşırı yükleme kullanıldığından, geri çağırma Graphics.DrawImageAbortfalsedöndürür ve bu da DrawImage yönteminin devam etmesine neden olur ve örnek ayarlanan görüntüyü ekrana çizer.

   // Define DrawImageAbort callback method.
private:
   bool DrawImageCallback8( IntPtr callBackData )
   {
      // Test for call that passes callBackData parameter.
      if ( callBackData == IntPtr::Zero )
      {
         
         // If no callBackData passed, abort DrawImage method.
         return true;
      }
      else
      {
         
         // If callBackData passed, continue DrawImage method.
         return false;
      }
   }

public:
   void DrawImageRect4FloatAttribAbortData( PaintEventArgs^ e )
   {
      // Create callback method.
      Graphics::DrawImageAbort^ imageCallback = gcnew Graphics::DrawImageAbort( this, &Form1::DrawImageCallback8 );
      IntPtr imageCallbackData = IntPtr(1);

      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create rectangle for displaying original image.
      Rectangle destRect1 = Rectangle(100,25,450,150);

      // Create coordinates of rectangle for source image.
      float x = 50.0F;
      float y = 50.0F;
      float width = 150.0F;
      float height = 150.0F;
      GraphicsUnit units = GraphicsUnit::Pixel;

      // Draw original image to screen.
      e->Graphics->DrawImage( newImage, destRect1, x, y, width, height, units );

      // Create rectangle for adjusted image.
      Rectangle destRect2 = Rectangle(100,175,450,150);

      // Create image attributes and set large gamma.
      ImageAttributes^ imageAttr = gcnew ImageAttributes;
      imageAttr->SetGamma( 4.0F );

      // Draw adjusted image to screen.
      try
      {
         // Draw adjusted image to screen.
         e->Graphics->DrawImage( newImage, destRect2, x, y, width, height, units, imageAttr, imageCallback, imageCallbackData );
      }
      catch ( Exception^ ex ) 
      {
         e->Graphics->DrawString( ex->ToString(), gcnew System::Drawing::Font( "Arial",8 ), Brushes::Black, PointF(0,0) );
      }
   }

// Define DrawImageAbort callback method.
private bool DrawImageCallback8(IntPtr callBackData)
{
             
    // Test for call that passes callBackData parameter.
    if(callBackData==IntPtr.Zero)
    {
             
        // If no callBackData passed, abort DrawImage method.
        return true;
    }
    else
    {
             
        // If callBackData passed, continue DrawImage method.
        return false;
    }
}
public void DrawImageRect4FloatAttribAbortData(PaintEventArgs e)
{
             
    // Create callback method.
    Graphics.DrawImageAbort imageCallback
        = new Graphics.DrawImageAbort(DrawImageCallback8);
    IntPtr imageCallbackData = new IntPtr(1);
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create rectangle for displaying original image.
    Rectangle destRect1 = new Rectangle(100, 25, 450, 150);
             
    // Create coordinates of rectangle for source image.
    float x = 50.0F;
    float y = 50.0F;
    float width = 150.0F;
    float height = 150.0F;
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Draw original image to screen.
    e.Graphics.DrawImage(newImage, destRect1, x, y, width, height, units);
             
    // Create rectangle for adjusted image.
    Rectangle destRect2 = new Rectangle(100, 175, 450, 150);
             
    // Create image attributes and set large gamma.
    ImageAttributes imageAttr = new ImageAttributes();
    imageAttr.SetGamma(4.0F);
             
    // Draw adjusted image to screen.
    try
    {
        checked
        {
             
            // Draw adjusted image to screen.
            e.Graphics.DrawImage(
                newImage,
                destRect2,
                x, y,
                width, height,
                units,
                imageAttr,
                imageCallback,
                imageCallbackData);
        }
    }
    catch (Exception ex)
    {
        e.Graphics.DrawString(
            ex.ToString(),
            new Font("Arial", 8),
            Brushes.Black,
            new PointF(0, 0));
    }
}
Private Function DrawImageCallback8(ByVal callBackData As IntPtr) As Boolean

    ' Test for call that passes callBackData parameter.
    If callBackData.Equals(IntPtr.Zero) Then

        ' If no callBackData passed, abort DrawImage method.
        Return True
    Else

        ' If callBackData passed, continue DrawImage method.
        Return False
    End If
End Function
Public Sub DrawImageRect4FloatAttribAbortData(ByVal e As PaintEventArgs)

    ' Create callback method.
    Dim imageCallback As New _
    Graphics.DrawImageAbort(AddressOf DrawImageCallback8)
    Dim imageCallbackData As New IntPtr(1)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create rectangle for displaying original image.
    Dim destRect1 As New Rectangle(100, 25, 450, 150)

    ' Create coordinates of rectangle for source image.
    Dim x As Single = 50.0F
    Dim y As Single = 50.0F
    Dim width As Single = 150.0F
    Dim height As Single = 150.0F
    Dim units As GraphicsUnit = GraphicsUnit.Pixel

    ' Draw original image to screen.
    e.Graphics.DrawImage(newImage, destRect1, x, y, width, _
    height, units)

    ' Create rectangle for adjusted image.
    Dim destRect2 As New Rectangle(100, 175, 450, 150)

    ' Create image attributes and set large gamma.
    Dim imageAttr As New ImageAttributes
    imageAttr.SetGamma(4.0F)

    ' Draw adjusted image to screen.
    Try

        ' Draw adjusted image to screen.
        e.Graphics.DrawImage(newImage, destRect2, x, y, width, _
        height, units, imageAttr, imageCallback, imageCallbackData)
    Catch ex As Exception
        e.Graphics.DrawString(ex.ToString(), New Font("Arial", 8), _
        Brushes.Black, New PointF(0, 0))
    End Try
End Sub

Açıklamalar

srcX, srcY, srcWidthve srcHeight parametreleri, çizilmesi gereken image nesnesinin dikdörtgen bir bölümünü belirtir. Dikdörtgen, kaynak görüntünün sol üst köşesine göredir. Bu bölüm, destRect parametresi tarafından belirtilen dikdörtgenin içine sığacak şekilde ölçeklendirilir.

callback ve callbackData parametreleriyle yapılan bu aşırı yükleme, uygulama tarafından belirlenen ölçütlere ve verilere göre bir görüntünün çiziminin durdurulması için araçlar sağlar. Örneğin, bir uygulama büyük bir görüntü çizmeye başlayabilir ve kullanıcı görüntüyü ekrandan kaydırabilir ve bu durumda uygulama çizimi durdurabilir.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, Rectangle, Single, Single, Single, Single, GraphicsUnit)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, System::Drawing::Rectangle destRect, float srcX, float srcY, float srcWidth, float srcHeight, System::Drawing::GraphicsUnit srcUnit);
public void DrawImage (System.Drawing.Image image, System.Drawing.Rectangle destRect, float srcX, float srcY, float srcWidth, float srcHeight, System.Drawing.GraphicsUnit srcUnit);
member this.DrawImage : System.Drawing.Image * System.Drawing.Rectangle * single * single * single * single * System.Drawing.GraphicsUnit -> unit
Public Sub DrawImage (image As Image, destRect As Rectangle, srcX As Single, srcY As Single, srcWidth As Single, srcHeight As Single, srcUnit As GraphicsUnit)

Parametreler

image
Image

Çizmek için Image.

destRect
Rectangle

Çizilen görüntünün konumunu ve boyutunu belirten Rectangle yapısı. Görüntü dikdörtgene sığacak şekilde ölçeklendirilir.

srcX
Single

Çizecek kaynak görüntünün bölümünün sol üst köşesinin x koordinatı.

srcY
Single

Çizecek kaynak görüntünün bölümünün sol üst köşesinin y koordinatı.

srcWidth
Single

Çizecek kaynak görüntünün bölümünün genişliği.

srcHeight
Single

Çizecek kaynak görüntünün bölümünün yüksekliği.

srcUnit
GraphicsUnit

Kaynak dikdörtgeni belirlemek için kullanılan ölçü birimlerini belirten GraphicsUnit numaralandırmasının üyesi.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Görüntünün çizildiği hedef dikdörtgenin koordinatlarını oluşturur.

  • Görüntünün bir bölümünü ayıklamak için kaynak dikdörtgen oluşturur.

  • Kaynak dikdörtgenin ölçü birimini piksel olarak ayarlar.

  • Görüntüyü ekrana çizer.

Hedef dikdörtgenin konumu ekrandaki görüntüyü bulur, kaynak ve hedef dikdörtgenlerin boyutları çizilen görüntünün ölçeklendirileceğini belirler ve kaynak dikdörtgenin boyutu, özgün görüntünün hangi bölümünün ekrana çizileceğini belirler.

private:
   void DrawImageRect4Float( PaintEventArgs^ e )
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create rectangle for displaying image.
      Rectangle destRect = Rectangle(100,100,450,150);

      // Create coordinates of rectangle for source image.
      float x = 50.0F;
      float y = 50.0F;
      float width = 150.0F;
      float height = 150.0F;
      GraphicsUnit units = GraphicsUnit::Pixel;

      // Draw image to screen.
      e->Graphics->DrawImage( newImage, destRect, x, y, width, height, units );
   }
private void DrawImageRect4Float(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create rectangle for displaying image.
    Rectangle destRect = new Rectangle(100, 100, 450, 150);
             
    // Create coordinates of rectangle for source image.
    float x = 50.0F;
    float y = 50.0F;
    float width = 150.0F;
    float height = 150.0F;
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Draw image to screen.
    e.Graphics.DrawImage(newImage, destRect, x, y, width, height, units);
}
Private Sub DrawImageRect4Float(ByVal e As PaintEventArgs)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create rectangle for displaying image.
    Dim destRect As New Rectangle(100, 100, 450, 150)

    ' Create coordinates of rectangle for source image.
    Dim x As Single = 50.0F
    Dim y As Single = 50.0F
    Dim width As Single = 150.0F
    Dim height As Single = 150.0F
    Dim units As GraphicsUnit = GraphicsUnit.Pixel

    ' Draw image to screen.
    e.Graphics.DrawImage(newImage, destRect, x, y, width, height, _
    units)
End Sub

Açıklamalar

srcX, srcY, srcWidthve srcHeight parametreleri, çizilmesi gereken image nesnesinin dikdörtgen bir bölümünü belirtir. Dikdörtgen, kaynak görüntünün sol üst köşesine göredir. Bu bölüm, destRect parametresi tarafından belirtilen dikdörtgenin içine sığacak şekilde ölçeklendirilir.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, Int32, Int32, Int32, Int32)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen konumda ve belirtilen boyutta çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, int x, int y, int width, int height);
public void DrawImage (System.Drawing.Image image, int x, int y, int width, int height);
member this.DrawImage : System.Drawing.Image * int * int * int * int -> unit
Public Sub DrawImage (image As Image, x As Integer, y As Integer, width As Integer, height As Integer)

Parametreler

image
Image

Çizmek için Image.

x
Int32

Çizilen görüntünün sol üst köşesinin x koordinatı.

y
Int32

Çizilen görüntünün sol üst köşesinin y koordinatı.

width
Int32

Çizilen görüntünün genişliği.

height
Int32

Çizilen görüntünün yüksekliği.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Resmin çizildiği dikdörtgenin konumunu ve boyutunu oluşturur.

  • Görüntüyü ekrana çizer.

Dikdörtgenin konumu, görüntüyü ekranda bulur ve özgün görüntünün boyutu ve dikdörtgenin boyutu, çizilen görüntünün ölçeklendirileceğini belirler.

public:
   void DrawImage4Int( PaintEventArgs^ e )
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create coordinates for upper-left corner.
      // of image and for size of image.
      int x = 100;
      int y = 100;
      int width = 450;
      int height = 150;

      // Draw image to screen.
      e->Graphics->DrawImage( newImage, x, y, width, height );
   }
public void DrawImage4Int(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create coordinates for upper-left corner.
             
    // of image and for size of image.
    int x = 100;
    int y = 100;
    int width = 450;
    int height = 150;
             
    // Draw image to screen.
    e.Graphics.DrawImage(newImage, x, y, width, height);
}
Public Sub DrawImage4Int(ByVal e As PaintEventArgs)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create coordinates for upper-left corner

    ' of image and for size of image.
    Dim x As Integer = 100
    Dim y As Integer = 100
    Dim width As Integer = 450
    Dim height As Integer = 150

    ' Draw image to screen.
    e.Graphics.DrawImage(newImage, x, y, width, height)
End Sub

Açıklamalar

x, y, widthve height parametreleri tarafından tanımlanan dikdörtgen, çizilen görüntünün konumunu ve boyutunu belirler.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, Single, Single, Single, Single)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen konumda ve belirtilen boyutta çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, float x, float y, float width, float height);
public void DrawImage (System.Drawing.Image image, float x, float y, float width, float height);
member this.DrawImage : System.Drawing.Image * single * single * single * single -> unit
Public Sub DrawImage (image As Image, x As Single, y As Single, width As Single, height As Single)

Parametreler

image
Image

Çizmek için Image.

x
Single

Çizilen görüntünün sol üst köşesinin x koordinatı.

y
Single

Çizilen görüntünün sol üst köşesinin y koordinatı.

width
Single

Çizilen görüntünün genişliği.

height
Single

Çizilen görüntünün yüksekliği.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Resmin çizildiği dikdörtgenin konumunu ve boyutunu oluşturur.

  • Görüntüyü ekrana çizer.

Dikdörtgenin konumu, görüntüyü ekranda bulur ve özgün görüntünün boyutu ve dikdörtgenin boyutu, çizilen görüntünün ölçeklendirileceğini belirler.

public:
   void DrawImage4Float( PaintEventArgs^ e )
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create coordinates for upper-left corner.
      // of image and for size of image.
      float x = 100.0F;
      float y = 100.0F;
      float width = 450.0F;
      float height = 150.0F;

      // Draw image to screen.
      e->Graphics->DrawImage( newImage, x, y, width, height );
   }
public void DrawImage4Float(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create coordinates for upper-left corner.
             
    // of image and for size of image.
    float x = 100.0F;
    float y = 100.0F;
    float width = 450.0F;
    float height = 150.0F;
             
    // Draw image to screen.
    e.Graphics.DrawImage(newImage, x, y, width, height);
}
Public Sub DrawImage4Float(ByVal e As PaintEventArgs)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create coordinates for upper-left corner

    ' of image and for size of image.
    Dim x As Single = 100.0F
    Dim y As Single = 100.0F
    Dim width As Single = 450.0F
    Dim height As Single = 150.0F

    ' Draw image to screen.
    e.Graphics.DrawImage(newImage, x, y, width, height)
End Sub

Açıklamalar

x, y, widthve height parametreleri tarafından tanımlanan dikdörtgen, çizilen görüntünün konumunu ve boyutunu belirler.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, PointF[], RectangleF, GraphicsUnit, ImageAttributes)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, cli::array <System::Drawing::PointF> ^ destPoints, System::Drawing::RectangleF srcRect, System::Drawing::GraphicsUnit srcUnit, System::Drawing::Imaging::ImageAttributes ^ imageAttr);
public void DrawImage (System.Drawing.Image image, System.Drawing.PointF[] destPoints, System.Drawing.RectangleF srcRect, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes? imageAttr);
public void DrawImage (System.Drawing.Image image, System.Drawing.PointF[] destPoints, System.Drawing.RectangleF srcRect, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes imageAttr);
member this.DrawImage : System.Drawing.Image * System.Drawing.PointF[] * System.Drawing.RectangleF * System.Drawing.GraphicsUnit * System.Drawing.Imaging.ImageAttributes -> unit
Public Sub DrawImage (image As Image, destPoints As PointF(), srcRect As RectangleF, srcUnit As GraphicsUnit, imageAttr As ImageAttributes)

Parametreler

image
Image

Çizmek için Image.

destPoints
PointF[]

Paralelkenar tanımlayan üç PointF yapısı dizisi.

srcRect
RectangleF

Çizecek image nesnesinin bölümünü belirten RectangleF yapı.

srcUnit
GraphicsUnit

srcRect parametresi tarafından kullanılan ölçü birimlerini belirten GraphicsUnit numaralandırmasının üyesi.

imageAttr
ImageAttributes

image nesnesi için yeniden renklendirme ve gama bilgilerini belirten ImageAttributes.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Görüntünün çizildiği hedef paralelogramı tanımlayan noktalar oluşturur.

  • Görüntünün bir bölümünü ayıklamak için kaynak dikdörtgen oluşturur.

  • Kaynak dikdörtgenin ölçü birimini piksel olarak ayarlar.

  • Özgün görüntüyü ekrana çizer.

  • Ayarlanmış bir görüntünün çizildiği ek bir paralelogram oluşturur.

  • Düzeltilmiş görüntünün özniteliklerini oluşturur ve her zamankinden daha büyük bir gama değerine sahip olacak şekilde ayarlar.

  • Ayarlanmış görüntüyü ekrana çizer.

Özgün, ayarsız hedef paralelkenar için, konum görüntüyü ekranda bulur, kaynak dikdörtgenin boyutu ve hedef paralel grafiğin boyutu ve şekli, çizilen görüntünün ölçeklendirilip kırpılma durumunu belirler ve dikdörtgenin boyutu, özgün görüntünün hangi bölümünün ekrana çizileceğini belirler.

void DrawImageParaFRectFAttrib( PaintEventArgs^ e )
{
   // Create image.
   Image^ newImage = Image::FromFile( "SampImag.jpg" );

   // Create parallelogram for drawing original image.
   PointF ulCorner1 = PointF(100.0F,100.0F);
   PointF urCorner1 = PointF(325.0F,100.0F);
   PointF llCorner1 = PointF(150.0F,250.0F);
   array<PointF>^ destPara1 = {ulCorner1,urCorner1,llCorner1};

   // Create rectangle for source image.
   RectangleF srcRect = RectangleF(50.0F,50.0F,150.0F,150.0F);
   GraphicsUnit units = GraphicsUnit::Pixel;

   // Create parallelogram for drawing adjusted image.
   PointF ulCorner2 = PointF(325.0F,100.0F);
   PointF urCorner2 = PointF(550.0F,100.0F);
   PointF llCorner2 = PointF(375.0F,250.0F);
   array<PointF>^ destPara2 = {ulCorner2,urCorner2,llCorner2};

   // Draw original image to screen.
   e->Graphics->DrawImage( newImage, destPara1, srcRect, units );

   // Create image attributes and set large gamma.
   ImageAttributes^ imageAttr = gcnew ImageAttributes;
   imageAttr->SetGamma( 4.0F );

   // Draw adjusted image to screen.
   e->Graphics->DrawImage( newImage, destPara2, srcRect, units, imageAttr );
}
private void DrawImageParaFRectFAttrib(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create parallelogram for drawing original image.
    PointF ulCorner1 = new PointF(100.0F, 100.0F);
    PointF urCorner1 = new PointF(325.0F, 100.0F);
    PointF llCorner1 = new PointF(150.0F, 250.0F);
    PointF[] destPara1 = {ulCorner1, urCorner1, llCorner1};
             
    // Create rectangle for source image.
    RectangleF srcRect = new RectangleF(50.0F, 50.0F, 150.0F, 150.0F);
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Create parallelogram for drawing adjusted image.
    PointF ulCorner2 = new PointF(325.0F, 100.0F);
    PointF urCorner2 = new PointF(550.0F, 100.0F);
    PointF llCorner2 = new PointF(375.0F, 250.0F);
    PointF[] destPara2 = {ulCorner2, urCorner2, llCorner2};
             
    // Draw original image to screen.
    e.Graphics.DrawImage(newImage, destPara1, srcRect, units);
             
    // Create image attributes and set large gamma.
    ImageAttributes imageAttr = new ImageAttributes();
    imageAttr.SetGamma(4.0F);
             
    // Draw adjusted image to screen.
    e.Graphics.DrawImage(newImage, destPara2, srcRect, units, imageAttr);
}
Private Sub DrawImageParaFRectFAttrib(ByVal e As PaintEventArgs)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create parallelogram for drawing original image.
    Dim ulCorner1 As New PointF(100.0F, 100.0F)
    Dim urCorner1 As New PointF(325.0F, 100.0F)
    Dim llCorner1 As New PointF(150.0F, 250.0F)
    Dim destPara1 As PointF() = {ulCorner1, urCorner1, llCorner1}

    ' Create rectangle for source image.
    Dim srcRect As New RectangleF(50.0F, 50.0F, 150.0F, 150.0F)
    Dim units As GraphicsUnit = GraphicsUnit.Pixel

    ' Create parallelogram for drawing adjusted image.
    Dim ulCorner2 As New PointF(325.0F, 100.0F)
    Dim urCorner2 As New PointF(550.0F, 100.0F)
    Dim llCorner2 As New PointF(375.0F, 250.0F)
    Dim destPara2 As PointF() = {ulCorner2, urCorner2, llCorner2}

    ' Draw original image to screen.
    e.Graphics.DrawImage(newImage, destPara1, srcRect, units)

    ' Create image attributes and set large gamma.
    Dim imageAttr As New ImageAttributes
    imageAttr.SetGamma(4.0F)

    ' Draw adjusted image to screen.
    e.Graphics.DrawImage(newImage, destPara2, srcRect, units, _
    imageAttr)
End Sub

Açıklamalar

destPoints parametresi paralelkenarın üç noktasını belirtir. Üç PointF yapısı, paralelkenarın sol üst, sağ üst ve sol alt köşelerini temsil eder. Dördüncü nokta, paralelkenar oluşturmak için ilk üç noktadan elde edilir.

srcRect parametresi, çizecek image nesnesinin dikdörtgen bir bölümünü belirtir. Bu bölüm ölçeklendirilir ve destPoints parametresi tarafından belirtilen paralelkenarın içine sığacak şekilde yamlanır.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, Effect)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
public:
 void DrawImage(System::Drawing::Image ^ image, System::Drawing::Imaging::Effects::Effect ^ effect);
public void DrawImage (System.Drawing.Image image, System.Drawing.Imaging.Effects.Effect effect);
member this.DrawImage : System.Drawing.Image * System.Drawing.Imaging.Effects.Effect -> unit
Public Sub DrawImage (image As Image, effect As Effect)

Parametreler

image
Image
effect
Effect

Şunlara uygulanır

DrawImage(Image, Point)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image, belirtilen konumda özgün fiziksel boyutunu kullanarak çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, System::Drawing::Point point);
public void DrawImage (System.Drawing.Image image, System.Drawing.Point point);
member this.DrawImage : System.Drawing.Image * System.Drawing.Point -> unit
Public Sub DrawImage (image As Image, point As Point)

Parametreler

image
Image

Çizmek için Image.

point
Point

Çizilen görüntünün sol üst köşesinin konumunu temsil eden Point yapısı.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Resmin sol üst köşesini çizmek için bir nokta oluşturur.

  • Ölçeklendirilmemiş görüntüyü ekrana çizer.

private:
   void DrawImagePoint( 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->DrawImage( newImage, ulCorner );
   }
private void DrawImagePoint(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.DrawImage(newImage, ulCorner);
}
Private Sub DrawImagePoint(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.DrawImage(newImage, ulCorner)
End Sub

Açıklamalar

Image, piksel genişliği için bir değer ve yatay çözünürlük için bir değer (inç başına nokta) depolar. Bir görüntünün inç cinsinden ölçülen fiziksel genişliği, yatay çözünürlüğe bölünen piksel genişliğidir. Örneğin, piksel genişliği 216 ve yatay çözünürlüğü inç başına 72 nokta olan bir görüntünün fiziksel genişliği 3 inçtir. Benzer açıklamalar piksel yüksekliği ve fiziksel yükseklik için de geçerlidir.

Bu yöntem fiziksel boyutunu kullanarak bir görüntü çizer, böylece görüntü cihazının çözünürlüğünden (inç başına nokta) bağımsız olarak görüntünün boyutu inç cinsinden doğru olur. Örneğin, bir görüntünün piksel genişliği 216 ve yatay çözünürlüğü inç başına 72 nokta olduğunu varsayalım. Bu görüntüyü inç başına 96 nokta çözünürlüğüne sahip bir cihaza çizmek için bu yöntemi çağırırsanız, işlenen görüntünün piksel genişliği (216/72)*96 = 288 olur.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, Point[])

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen konumda ve belirtilen şekil ve boyutla çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, cli::array <System::Drawing::Point> ^ destPoints);
public void DrawImage (System.Drawing.Image image, System.Drawing.Point[] destPoints);
member this.DrawImage : System.Drawing.Image * System.Drawing.Point[] -> unit
Public Sub DrawImage (image As Image, destPoints As Point())

Parametreler

image
Image

Çizmek için Image.

destPoints
Point[]

Paralelkenar tanımlayan üç Point yapısı dizisi.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Görüntüyü çizmek için bir paralelogram tanımlayan noktalar oluşturur.

  • Görüntüyü ekrana çizer.

Paralel grafiğin konumu, görüntüyü ekranda bulur ve özgün görüntünün boyutu ile paralelkenarın boyutu ve şekli, çizilen görüntünün ölçeklendirilip kırpılması için belirler.

private:
   void DrawImagePara( PaintEventArgs^ e )
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create parallelogram for drawing image.
      Point ulCorner = Point(100,100);
      Point urCorner = Point(550,100);
      Point llCorner = Point(150,250);
      array<Point>^ destPara = {ulCorner,urCorner,llCorner};

      // Draw image to screen.
      e->Graphics->DrawImage( newImage, destPara );
   }
private void DrawImagePara(PaintEventArgs e)
{
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create parallelogram for drawing image.
    Point ulCorner = new Point(100, 100);
    Point urCorner = new Point(550, 100);
    Point llCorner = new Point(150, 250);
    Point[] destPara = {ulCorner, urCorner, llCorner};
             
    // Draw image to screen.
    e.Graphics.DrawImage(newImage, destPara);
}
Private Sub DrawImagePara(ByVal e As PaintEventArgs)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create parallelogram for drawing image.
    Dim ulCorner As New Point(100, 100)
    Dim urCorner As New Point(550, 100)
    Dim llCorner As New Point(150, 250)
    Dim destPara As Point() = {ulCorner, urCorner, llCorner}

    ' Draw image to screen.
    e.Graphics.DrawImage(newImage, destPara)
End Sub

Açıklamalar

destPoints parametresi paralelkenarın üç noktasını belirtir. Üç Point yapısı, paralelkenarın sol üst, sağ üst ve sol alt köşelerini temsil eder. Dördüncü nokta, paralelkenar oluşturmak için ilk üç noktadan elde edilir.

image parametresi tarafından temsil edilen görüntü ölçeklendirilir ve destPoints parametreleri tarafından belirtilen paralelkenarın şekline uyacak şekilde kırpılır.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, PointF)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image, belirtilen konumda özgün fiziksel boyutunu kullanarak çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, System::Drawing::PointF point);
public void DrawImage (System.Drawing.Image image, System.Drawing.PointF point);
member this.DrawImage : System.Drawing.Image * System.Drawing.PointF -> unit
Public Sub DrawImage (image As Image, point As PointF)

Parametreler

image
Image

Çizmek için Image.

point
PointF

Çizilen görüntünün sol üst köşesini temsil eden PointF yapısı.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Resmin sol üst köşesini çizmek için bir nokta oluşturur.

  • Ölçeklendirilmemiş görüntüyü ekrana çizer.

private:
   void DrawImagePointF( PaintEventArgs^ e )
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create point for upper-left corner of image.
      PointF ulCorner = PointF(100.0F,100.0F);

      // Draw image to screen.
      e->Graphics->DrawImage( newImage, ulCorner );
   }
private void DrawImagePointF(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create point for upper-left corner of image.
    PointF ulCorner = new PointF(100.0F, 100.0F);
             
    // Draw image to screen.
    e.Graphics.DrawImage(newImage, ulCorner);
}
Private Sub DrawImagePointF(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 PointF(100.0F, 100.0F)

    ' Draw image to screen.
    e.Graphics.DrawImage(newImage, ulCorner)
End Sub

Açıklamalar

Image, piksel genişliği için bir değer ve yatay çözünürlük için bir değer (inç başına nokta) depolar. Bir görüntünün inç cinsinden ölçülen fiziksel genişliği, yatay çözünürlüğe bölünen piksel genişliğidir. Örneğin, piksel genişliği 216 ve yatay çözünürlüğü inç başına 72 nokta olan bir görüntünün fiziksel genişliği 3 inçtir. Benzer açıklamalar piksel yüksekliği ve fiziksel yükseklik için de geçerlidir.

Bu yöntem fiziksel boyutunu kullanarak bir görüntü çizer, böylece görüntü cihazının çözünürlüğünden (inç başına nokta) bağımsız olarak görüntünün boyutu inç cinsinden doğru olur. Örneğin, bir görüntünün piksel genişliği 216 ve yatay çözünürlüğü inç başına 72 nokta olduğunu varsayalım. Bu görüntüyü inç başına 96 nokta çözünürlüğüne sahip bir cihaza çizmek için bu yöntemi çağırırsanız, işlenen görüntünün piksel genişliği (216/72)*96 = 288 olur.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, PointF[])

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen konumda ve belirtilen şekil ve boyutla çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, cli::array <System::Drawing::PointF> ^ destPoints);
public void DrawImage (System.Drawing.Image image, System.Drawing.PointF[] destPoints);
member this.DrawImage : System.Drawing.Image * System.Drawing.PointF[] -> unit
Public Sub DrawImage (image As Image, destPoints As PointF())

Parametreler

image
Image

Çizmek için Image.

destPoints
PointF[]

Paralelkenar tanımlayan üç PointF yapısı dizisi.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Görüntüyü çizmek için bir paralelogram tanımlayan noktalar oluşturur.

  • Görüntüyü ekrana çizer.

Paralel grafiğin konumu, görüntüyü ekranda bulur ve özgün görüntünün boyutu ile paralelkenarın boyutu ve şekli, çizilen görüntünün ölçeklendirilip kırpılması için belirler.

private:
   void DrawImageParaF( PaintEventArgs^ e )
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create parallelogram for drawing image.
      PointF ulCorner = PointF(100.0F,100.0F);
      PointF urCorner = PointF(550.0F,100.0F);
      PointF llCorner = PointF(150.0F,250.0F);
      array<PointF>^ destPara = {ulCorner,urCorner,llCorner};

      // Draw image to screen.
      e->Graphics->DrawImage( newImage, destPara );
   }
private void DrawImageParaF(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create parallelogram for drawing image.
    PointF ulCorner = new PointF(100.0F, 100.0F);
    PointF urCorner = new PointF(550.0F, 100.0F);
    PointF llCorner = new PointF(150.0F, 250.0F);
    PointF[] destPara = {ulCorner, urCorner, llCorner};
             
    // Draw image to screen.
    e.Graphics.DrawImage(newImage, destPara);
}
Private Sub DrawImageParaF(ByVal e As PaintEventArgs)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create parallelogram for drawing image.
    Dim ulCorner As New PointF(100.0F, 100.0F)
    Dim urCorner As New PointF(550.0F, 100.0F)
    Dim llCorner As New PointF(150.0F, 250.0F)
    Dim destPara As PointF() = {ulCorner, urCorner, llCorner}

    ' Draw image to screen.
    e.Graphics.DrawImage(newImage, destPara)
End Sub

Açıklamalar

destPoints parametresi paralelkenarın üç noktasını belirtir. Üç PointF yapısı, paralelkenarın sol üst, sağ üst ve sol alt köşelerini temsil eder. Dördüncü nokta, paralelkenar oluşturmak için ilk üç noktadan elde edilir.

image nesnesi tarafından temsil edilen görüntü ölçeklendirilir ve destPoints parametresi tarafından belirtilen paralel grafiğin şekline uyacak şekilde kırpılır.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, Rectangle)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen konumda ve belirtilen boyutta çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, System::Drawing::Rectangle rect);
public void DrawImage (System.Drawing.Image image, System.Drawing.Rectangle rect);
member this.DrawImage : System.Drawing.Image * System.Drawing.Rectangle -> unit
Public Sub DrawImage (image As Image, rect As Rectangle)

Parametreler

image
Image

Çizmek için Image.

rect
Rectangle

Çizilen görüntünün konumunu ve boyutunu belirten Rectangle yapısı.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Resmin çizildiği bir dikdörtgen oluşturur.

  • Görüntüyü ekrana çizer.

Dikdörtgenin konumu, görüntüyü ekranda bulur ve özgün görüntünün boyutu ve dikdörtgenin boyutu, çizilen görüntünün ölçeklendirileceğini belirler.

private:
   void DrawImageRect( PaintEventArgs^ e )
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create rectangle for displaying image.
      Rectangle destRect = Rectangle(100,100,450,150);

      // Draw image to screen.
      e->Graphics->DrawImage( newImage, destRect );
   }
private void DrawImageRect(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create rectangle for displaying image.
    Rectangle destRect = new Rectangle(100, 100, 450, 150);
             
    // Draw image to screen.
    e.Graphics.DrawImage(newImage, destRect);
}
Private Sub DrawImageRect(ByVal e As PaintEventArgs)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create rectangle for displaying image.
    Dim destRect As New Rectangle(100, 100, 450, 150)

    ' Draw image to screen.
    e.Graphics.DrawImage(newImage, destRect)
End Sub

Açıklamalar

image nesnesi tarafından temsil edilen görüntü, rect dikdörtgenin boyutlarına ölçeklendirilir.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, RectangleF)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen konumda ve belirtilen boyutta çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, System::Drawing::RectangleF rect);
public void DrawImage (System.Drawing.Image image, System.Drawing.RectangleF rect);
member this.DrawImage : System.Drawing.Image * System.Drawing.RectangleF -> unit
Public Sub DrawImage (image As Image, rect As RectangleF)

Parametreler

image
Image

Çizmek için Image.

rect
RectangleF

Çizilen görüntünün konumunu ve boyutunu belirten RectangleF yapısı.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Resmin çizildiği bir dikdörtgen oluşturur.

  • Görüntüyü ekrana çizer.

Dikdörtgenin konumu ekrandaki görüntüyü bulur ve resmin özgün boyutu ve dikdörtgenin boyutu, çizilen görüntünün ölçeklendirileceğini belirler.

public:
   void DrawImageRectF( PaintEventArgs^ e )
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create rectangle for displaying image.
      RectangleF rect = RectangleF(100.0F,100.0F,450.0F,150.0F);

      // Draw image to screen.
      e->Graphics->DrawImage( newImage, rect );
   }
public void DrawImageRectF(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create rectangle for displaying image.
    RectangleF rect = new RectangleF(100.0F, 100.0F, 450.0F, 150.0F);
             
    // Draw image to screen.
    e.Graphics.DrawImage(newImage, rect);
}
Public Sub DrawImageRectF(ByVal e As PaintEventArgs)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create rectangle for displaying image.
    Dim rect As New RectangleF(100.0F, 100.0F, 450.0F, 150.0F)

    ' Draw image to screen.
    e.Graphics.DrawImage(newImage, rect)
End Sub

Açıklamalar

image nesnesi tarafından temsil edilen görüntü, rect dikdörtgenin boyutlarına ölçeklendirilir.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, Int32, Int32, Rectangle, GraphicsUnit)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Görüntünün belirli bir konuma bir bölümünü çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, int x, int y, System::Drawing::Rectangle srcRect, System::Drawing::GraphicsUnit srcUnit);
public void DrawImage (System.Drawing.Image image, int x, int y, System.Drawing.Rectangle srcRect, System.Drawing.GraphicsUnit srcUnit);
member this.DrawImage : System.Drawing.Image * int * int * System.Drawing.Rectangle * System.Drawing.GraphicsUnit -> unit
Public Sub DrawImage (image As Image, x As Integer, y As Integer, srcRect As Rectangle, srcUnit As GraphicsUnit)

Parametreler

image
Image

Çizmek için Image.

x
Int32

Çizilen görüntünün sol üst köşesinin x koordinatı.

y
Int32

Çizilen görüntünün sol üst köşesinin y koordinatı.

srcRect
Rectangle

Çizecek image nesnesinin bölümünü belirten Rectangle yapı.

srcUnit
GraphicsUnit

srcRect parametresi tarafından kullanılan ölçü birimlerini belirten GraphicsUnit numaralandırmasının üyesi.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Görüntünün sol üst köşesini çizmek için koordinatları oluşturur.

  • Görüntünün bir bölümünü ayıklamak için kaynak dikdörtgen oluşturur.

  • Kaynak dikdörtgenin ölçü birimini piksel olarak ayarlar.

  • Görüntüyü ekrana çizer.

Kaynak dikdörtgenin boyutu, ölçeklendirilmemiş özgün görüntünün hangi bölümünün ekrana çizileceğini belirler.

public:
   void DrawImage2IntRect( PaintEventArgs^ e )
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create coordinates for upper-left corner of image.
      int x = 100;
      int y = 100;

      // Create rectangle for source image.
      Rectangle srcRect = Rectangle(50,50,150,150);
      GraphicsUnit units = GraphicsUnit::Pixel;

      // Draw image to screen.
      e->Graphics->DrawImage( newImage, x, y, srcRect, units );
   }
public void DrawImage2IntRect(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create coordinates for upper-left corner of image.
    int x = 100;
    int y = 100;
             
    // Create rectangle for source image.
    Rectangle srcRect = new Rectangle(50, 50, 150, 150);
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Draw image to screen.
    e.Graphics.DrawImage(newImage, x, y, srcRect, units);
}
Public Sub DrawImage2IntRect(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

    ' Create rectangle for source image.
    Dim srcRect As New Rectangle(50, 50, 150, 150)
    Dim units As GraphicsUnit = GraphicsUnit.Pixel

    ' Draw image to screen.
    e.Graphics.DrawImage(newImage, x, y, srcRect, units)
End Sub

Açıklamalar

Image, piksel genişliği için bir değer ve yatay çözünürlük için bir değer (inç başına nokta) depolar. Bir görüntünün inç cinsinden ölçülen fiziksel genişliği, yatay çözünürlüğe bölünen piksel genişliğidir. Örneğin, piksel genişliği 360 olan ve yatay çözünürlüğü inç başına 72 nokta olan bir görüntünün fiziksel genişliği 5 inçtir. Benzer açıklamalar piksel yüksekliği ve fiziksel yükseklik için de geçerlidir.

Bu yöntem, fiziksel boyutunu kullanarak görüntünün bir bölümünü çizer, dolayısıyla görüntü bölümünün boyutu, görüntü cihazının çözünürlüğünden (inç başına nokta sayısı) bağımsız olarak inç cinsinden doğru boyutuna sahip olur. Örneğin, bir görüntü bölümünün piksel genişliği 216 ve yatay çözünürlüğü inç başına 72 nokta olduğunu varsayalım. Bu görüntü bölümünü inç başına 96 nokta çözünürlüğüne sahip bir cihaza çizmek için bu yöntemi çağırırsanız, işlenen görüntü bölümünün piksel genişliği (216/72)*96 = 288 olur.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, Single, Single)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image, belirtilen konumda özgün fiziksel boyutunu kullanarak çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, float x, float y);
public void DrawImage (System.Drawing.Image image, float x, float y);
member this.DrawImage : System.Drawing.Image * single * single -> unit
Public Sub DrawImage (image As Image, x As Single, y As Single)

Parametreler

image
Image

Çizmek için Image.

x
Single

Çizilen görüntünün sol üst köşesinin x koordinatı.

y
Single

Çizilen görüntünün sol üst köşesinin y koordinatı.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Görüntünün sol üst köşesini çizecek bir noktanın koordinatlarını oluşturur.

  • Ölçeklendirilmemiş görüntüyü ekrana çizer.

public:
   void DrawImage2Float( PaintEventArgs^ e )
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create coordinates for upper-left corner of image.
      float x = 100.0F;
      float y = 100.0F;

      // Draw image to screen.
      e->Graphics->DrawImage( newImage, x, y );
   }
public void DrawImage2Float(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create coordinates for upper-left corner of image.
    float x = 100.0F;
    float y = 100.0F;
             
    // Draw image to screen.
    e.Graphics.DrawImage(newImage, x, y);
}
Public Sub DrawImage2Float(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 Single = 100.0F
    Dim y As Single = 100.0F

    ' Draw image to screen.
    e.Graphics.DrawImage(newImage, x, y)
End Sub

Açıklamalar

Image, piksel genişliği için bir değer ve yatay çözünürlük için bir değer (inç başına nokta) depolar. Bir görüntünün inç cinsinden ölçülen fiziksel genişliği, yatay çözünürlüğe bölünen piksel genişliğidir. Örneğin, piksel genişliği 216 ve yatay çözünürlüğü inç başına 72 nokta olan bir görüntünün fiziksel genişliği 3 inçtir. Benzer açıklamalar piksel yüksekliği ve fiziksel yükseklik için de geçerlidir.

Bu yöntem fiziksel boyutunu kullanarak bir görüntü çizer, böylece görüntü cihazının çözünürlüğünden (inç başına nokta) bağımsız olarak görüntünün boyutu inç cinsinden doğru olur. Örneğin, bir görüntünün piksel genişliği 216 ve yatay çözünürlüğü inç başına 72 nokta olduğunu varsayalım. Bu görüntüyü inç başına 96 nokta çözünürlüğüne sahip bir cihaza çizmek için bu yöntemi çağırırsanız, işlenen görüntünün piksel genişliği (216/72)*96 = 288 olur.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, Point[], Rectangle, GraphicsUnit)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, cli::array <System::Drawing::Point> ^ destPoints, System::Drawing::Rectangle srcRect, System::Drawing::GraphicsUnit srcUnit);
public void DrawImage (System.Drawing.Image image, System.Drawing.Point[] destPoints, System.Drawing.Rectangle srcRect, System.Drawing.GraphicsUnit srcUnit);
member this.DrawImage : System.Drawing.Image * System.Drawing.Point[] * System.Drawing.Rectangle * System.Drawing.GraphicsUnit -> unit
Public Sub DrawImage (image As Image, destPoints As Point(), srcRect As Rectangle, srcUnit As GraphicsUnit)

Parametreler

image
Image

Çizmek için Image.

destPoints
Point[]

Paralelkenar tanımlayan üç Point yapısı dizisi.

srcRect
Rectangle

Çizecek image nesnesinin bölümünü belirten Rectangle yapı.

srcUnit
GraphicsUnit

srcRect parametresi tarafından kullanılan ölçü birimlerini belirten GraphicsUnit numaralandırmasının üyesi.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Görüntüyü çizmek için bir paralelogram tanımlayan noktalar oluşturur.

  • Resmin çizecek bölümünü seçmek için bir dikdörtgen oluşturur.

  • Grafik çizim birimini piksel olarak ayarlar.

  • Görüntüyü ekrana çizer.

Paralel grafiğin konumu ekrandaki görüntüyü bulur ve dikdörtgenin boyutu ile paralelkenarın boyutu ve şekli, çizilen görüntünün ölçeklendirilip kırpılması için belirler.

private:
   void DrawImageParaRect( PaintEventArgs^ e )
   {

      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create parallelogram for drawing image.
      Point ulCorner = Point(100,100);
      Point urCorner = Point(325,100);
      Point llCorner = Point(150,250);
      array<Point>^ destPara = {ulCorner,urCorner,llCorner};

      // Create rectangle for source image.
      Rectangle srcRect = Rectangle(50,50,150,150);
      GraphicsUnit units = GraphicsUnit::Pixel;

      // Draw image to screen.
      e->Graphics->DrawImage( newImage, destPara, srcRect, units );
   }
private void DrawImageParaRect(PaintEventArgs e)
{
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create parallelogram for drawing image.
    Point ulCorner = new Point(100, 100);
    Point urCorner = new Point(325, 100);
    Point llCorner = new Point(150, 250);
    Point[] destPara = {ulCorner, urCorner, llCorner};
             
    // Create rectangle for source image.
    Rectangle srcRect = new Rectangle(50, 50, 150, 150);
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Draw image to screen.
    e.Graphics.DrawImage(newImage, destPara, srcRect, units);
}
Private Sub DrawImageParaRect(ByVal e As PaintEventArgs)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create parallelogram for drawing image.
    Dim ulCorner As New Point(100, 100)
    Dim urCorner As New Point(325, 100)
    Dim llCorner As New Point(150, 250)
    Dim destPara As Point() = {ulCorner, urCorner, llCorner}

    ' Create rectangle for source image.
    Dim srcRect As New Rectangle(50, 50, 150, 150)
    Dim units As GraphicsUnit = GraphicsUnit.Pixel

    ' Draw image to screen.
    e.Graphics.DrawImage(newImage, destPara, srcRect, units)
End Sub

Açıklamalar

destPoints parametresi paralelkenarın üç noktasını belirtir. Üç Point yapısı, paralelkenarın sol üst, sağ üst ve sol alt köşelerini temsil eder. Dördüncü nokta, paralelkenar oluşturmak için ilk üç noktadan elde edilir.

srcRect parametresi, çizecek image nesnesinin dikdörtgen bir bölümünü belirtir. Bu bölüm ölçeklendirilir ve destPoints parametresi tarafından belirtilen paralelkenarın içine sığacak şekilde yamlanır.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, PointF[], RectangleF, GraphicsUnit)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, cli::array <System::Drawing::PointF> ^ destPoints, System::Drawing::RectangleF srcRect, System::Drawing::GraphicsUnit srcUnit);
public void DrawImage (System.Drawing.Image image, System.Drawing.PointF[] destPoints, System.Drawing.RectangleF srcRect, System.Drawing.GraphicsUnit srcUnit);
member this.DrawImage : System.Drawing.Image * System.Drawing.PointF[] * System.Drawing.RectangleF * System.Drawing.GraphicsUnit -> unit
Public Sub DrawImage (image As Image, destPoints As PointF(), srcRect As RectangleF, srcUnit As GraphicsUnit)

Parametreler

image
Image

Çizmek için Image.

destPoints
PointF[]

Paralelkenar tanımlayan üç PointF yapısı dizisi.

srcRect
RectangleF

Çizecek image nesnesinin bölümünü belirten RectangleF yapı.

srcUnit
GraphicsUnit

srcRect parametresi tarafından kullanılan ölçü birimlerini belirten GraphicsUnit numaralandırmasının üyesi.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Görüntünün çizildiği hedef paralelogramı tanımlayan noktalar oluşturur.

  • Görüntünün bir bölümünü ayıklamak için kaynak dikdörtgen oluşturur.

  • Kaynak dikdörtgenin ölçü birimini piksel olarak ayarlar.

  • Görüntüyü ekrana çizer.

Hedef paralelkenarın konumu ekrandaki görüntüyü bulur, kaynak dikdörtgenin boyutu ve hedef paralelkenarın boyutu ve şekli, çizilen görüntünün ölçeklendirilip kırpılması ile dikdörtgenin boyutu, özgün görüntünün hangi bölümünün ekrana çizileceğini belirler.

private:
   void DrawImageParaFRectF( PaintEventArgs^ e )
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create parallelogram for drawing image.
      PointF ulCorner = PointF(100.0F,100.0F);
      PointF urCorner = PointF(550.0F,100.0F);
      PointF llCorner = PointF(150.0F,250.0F);
      array<PointF>^ destPara = {ulCorner,urCorner,llCorner};

      // Create rectangle for source image.
      RectangleF srcRect = RectangleF(50.0F,50.0F,150.0F,150.0F);
      GraphicsUnit units = GraphicsUnit::Pixel;

      // Draw image to screen.
      e->Graphics->DrawImage( newImage, destPara, srcRect, units );
   }
private void DrawImageParaFRectF(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create parallelogram for drawing image.
    PointF ulCorner = new PointF(100.0F, 100.0F);
    PointF urCorner = new PointF(550.0F, 100.0F);
    PointF llCorner = new PointF(150.0F, 250.0F);
    PointF[] destPara = {ulCorner, urCorner, llCorner};
             
    // Create rectangle for source image.
    RectangleF srcRect = new RectangleF(50.0F, 50.0F, 150.0F, 150.0F);
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Draw image to screen.
    e.Graphics.DrawImage(newImage, destPara, srcRect, units);
}
Private Sub DrawImageParaFRectF(ByVal e As PaintEventArgs)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create parallelogram for drawing image.
    Dim ulCorner As New PointF(100.0F, 100.0F)
    Dim urCorner As New PointF(550.0F, 100.0F)
    Dim llCorner As New PointF(150.0F, 250.0F)
    Dim destPara As PointF() = {ulCorner, urCorner, llCorner}

    ' Create rectangle for source image.
    Dim srcRect As New RectangleF(50.0F, 50.0F, 150.0F, 150.0F)
    Dim units As GraphicsUnit = GraphicsUnit.Pixel

    ' Draw image to screen.
    e.Graphics.DrawImage(newImage, destPara, srcRect, units)
End Sub

Açıklamalar

destPoints parametresi paralelkenarın üç noktasını belirtir. Üç PointF yapısı, paralelkenarın sol üst, sağ üst ve sol alt köşelerini temsil eder. Dördüncü nokta, paralelkenar oluşturmak için ilk üç noktadan elde edilir.

srcRect parametresi, çizecek image nesnesinin dikdörtgen bir bölümünü belirtir. Bu bölüm ölçeklendirilir ve destPoints parametresi tarafından belirtilen paralelkenarın içine sığacak şekilde yamlanır.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, Rectangle, Rectangle, GraphicsUnit)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, System::Drawing::Rectangle destRect, System::Drawing::Rectangle srcRect, System::Drawing::GraphicsUnit srcUnit);
public void DrawImage (System.Drawing.Image image, System.Drawing.Rectangle destRect, System.Drawing.Rectangle srcRect, System.Drawing.GraphicsUnit srcUnit);
member this.DrawImage : System.Drawing.Image * System.Drawing.Rectangle * System.Drawing.Rectangle * System.Drawing.GraphicsUnit -> unit
Public Sub DrawImage (image As Image, destRect As Rectangle, srcRect As Rectangle, srcUnit As GraphicsUnit)

Parametreler

image
Image

Çizmek için Image.

destRect
Rectangle

Çizilen görüntünün konumunu ve boyutunu belirten Rectangle yapısı. Görüntü dikdörtgene sığacak şekilde ölçeklendirilir.

srcRect
Rectangle

Çizecek image nesnesinin bölümünü belirten Rectangle yapı.

srcUnit
GraphicsUnit

srcRect parametresi tarafından kullanılan ölçü birimlerini belirten GraphicsUnit numaralandırmasının üyesi.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Resmin çizildiği hedef dikdörtgeni oluşturur.

  • Görüntünün bir bölümünü ayıklamak için kaynak dikdörtgen oluşturur.

  • Kaynak dikdörtgenin ölçü birimini piksel olarak ayarlar.

  • Görüntüyü ekrana çizer.

Hedef dikdörtgenin konumu ekrandaki görüntüyü bulur, kaynak ve hedef dikdörtgenlerin boyutları çizilen görüntünün ölçeklendirileceğini belirler ve kaynak dikdörtgenin boyutu, özgün görüntünün hangi bölümünün ekrana çizileceğini belirler.

private:
   void DrawImageRectRect( PaintEventArgs^ e )
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create rectangle for displaying image.
      Rectangle destRect = Rectangle(100,100,450,150);

      // Create rectangle for source image.
      Rectangle srcRect = Rectangle(50,50,150,150);
      GraphicsUnit units = GraphicsUnit::Pixel;

      // Draw image to screen.
      e->Graphics->DrawImage( newImage, destRect, srcRect, units );
   }
private void DrawImageRectRect(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create rectangle for displaying image.
    Rectangle destRect = new Rectangle(100, 100, 450, 150);
             
    // Create rectangle for source image.
    Rectangle srcRect = new Rectangle(50, 50, 150, 150);
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Draw image to screen.
    e.Graphics.DrawImage(newImage, destRect, srcRect, units);
}
Private Sub DrawImageRectRect(ByVal e As PaintEventArgs)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create rectangle for displaying image.
    Dim destRect As New Rectangle(100, 100, 450, 150)

    ' Create rectangle for source image.
    Dim srcRect As New Rectangle(50, 50, 150, 150)
    Dim units As GraphicsUnit = GraphicsUnit.Pixel

    ' Draw image to screen.
    e.Graphics.DrawImage(newImage, destRect, srcRect, units)
End Sub

Açıklamalar

srcRect parametresi, çizecek image nesnesinin dikdörtgen bir bölümünü belirtir. Bu bölüm, destRect parametresi tarafından belirtilen dikdörtgenin içine sığacak şekilde ölçeklendirilir.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, RectangleF, RectangleF, GraphicsUnit)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen Image belirtilen kısmını belirtilen konumda ve belirtilen boyutla çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, System::Drawing::RectangleF destRect, System::Drawing::RectangleF srcRect, System::Drawing::GraphicsUnit srcUnit);
public void DrawImage (System.Drawing.Image image, System.Drawing.RectangleF destRect, System.Drawing.RectangleF srcRect, System.Drawing.GraphicsUnit srcUnit);
member this.DrawImage : System.Drawing.Image * System.Drawing.RectangleF * System.Drawing.RectangleF * System.Drawing.GraphicsUnit -> unit
Public Sub DrawImage (image As Image, destRect As RectangleF, srcRect As RectangleF, srcUnit As GraphicsUnit)

Parametreler

image
Image

Çizmek için Image.

destRect
RectangleF

Çizilen görüntünün konumunu ve boyutunu belirten RectangleF yapısı. Görüntü dikdörtgene sığacak şekilde ölçeklendirilir.

srcRect
RectangleF

Çizecek image nesnesinin bölümünü belirten RectangleF yapı.

srcUnit
GraphicsUnit

srcRect parametresi tarafından kullanılan ölçü birimlerini belirten GraphicsUnit numaralandırmasının üyesi.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Resmin çizildiği hedef dikdörtgeni oluşturur.

  • Görüntünün bir bölümünü ayıklamak için kaynak dikdörtgen oluşturur.

  • Kaynak dikdörtgenin ölçü birimini piksel olarak ayarlar.

  • Görüntüyü ekrana çizer.

Hedef dikdörtgenin konumu ekrandaki görüntüyü bulur, kaynak ve hedef dikdörtgenlerin boyutları çizilen görüntünün ölçeklendirileceğini belirler ve kaynak dikdörtgenin boyutu, özgün görüntünün hangi bölümünün ekrana çizileceğini belirler.

public:
   void DrawImageRectFRectF( PaintEventArgs^ e )
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create rectangle for displaying image.
      RectangleF destRect = RectangleF(100.0F,100.0F,450.0F,150.0F);

      // Create rectangle for source image.
      RectangleF srcRect = RectangleF(50.0F,50.0F,150.0F,150.0F);
      GraphicsUnit units = GraphicsUnit::Pixel;

      // Draw image to screen.
      e->Graphics->DrawImage( newImage, destRect, srcRect, units );
   }
public void DrawImageRectFRectF(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create rectangle for displaying image.
    RectangleF destRect = new RectangleF(100.0F, 100.0F, 450.0F, 150.0F);
             
    // Create rectangle for source image.
    RectangleF srcRect = new RectangleF(50.0F, 50.0F, 150.0F, 150.0F);
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Draw image to screen.
    e.Graphics.DrawImage(newImage, destRect, srcRect, units);
}
Public Sub DrawImageRectFRectF(ByVal e As PaintEventArgs)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create rectangle for displaying image.
    Dim destRect As New RectangleF(100.0F, 100.0F, 450.0F, 150.0F)

    ' Create rectangle for source image.
    Dim srcRect As New RectangleF(50.0F, 50.0F, 150.0F, 150.0F)
    Dim units As GraphicsUnit = GraphicsUnit.Pixel

    ' Draw image to screen.
    e.Graphics.DrawImage(newImage, destRect, srcRect, units)
End Sub

Açıklamalar

srcRect parametresi, çizecek image nesnesinin dikdörtgen bir bölümünü belirtir. Bu bölüm, destRect parametresi tarafından belirtilen dikdörtgenin içine sığacak şekilde ölçeklendirilir.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, Int32, Int32)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen görüntüyü özgün fiziksel boyutunu kullanarak koordinat çifti tarafından belirtilen konuma çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, int x, int y);
public void DrawImage (System.Drawing.Image image, int x, int y);
member this.DrawImage : System.Drawing.Image * int * int -> unit
Public Sub DrawImage (image As Image, x As Integer, y As Integer)

Parametreler

image
Image

Çizmek için Image.

x
Int32

Çizilen görüntünün sol üst köşesinin x koordinatı.

y
Int32

Çizilen görüntünün sol üst köşesinin y koordinatı.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründeki SampImag.jpg örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Görüntünün sol üst köşesini çizecek bir noktanın koordinatlarını oluşturur.

  • Ölçeklendirilmemiş görüntüyü çizer.

public:
   void DrawImage2Int( 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->DrawImage( newImage, x, y );
   }
public void DrawImage2Int(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.DrawImage(newImage, x, y);
}
Public Sub DrawImage2Int(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.DrawImage(newImage, x, y)
End Sub

Açıklamalar

Image, piksel genişliği için bir değer ve yatay çözünürlük için bir değer (inç başına nokta) depolar. Bir görüntünün inç cinsinden ölçülen fiziksel genişliği, yatay çözünürlüğe bölünen piksel genişliğidir. Örneğin, piksel genişliği 216 ve yatay çözünürlüğü inç başına 72 nokta olan bir görüntünün fiziksel genişliği 3 inçtir. Benzer açıklamalar piksel yüksekliği ve fiziksel yükseklik için de geçerlidir.

DrawImage yöntemi, fiziksel boyutunu kullanarak bir görüntü çizer, böylece görüntü cihazının çözünürlüğünden (inç başına nokta) bağımsız olarak görüntünün boyutu inç cinsinden doğru olur. Örneğin, bir görüntünün piksel genişliği 216 ve yatay çözünürlüğü inç başına 72 nokta olduğunu varsayalım. bu görüntüyü inç başına 96 nokta çözünürlüğüne sahip bir cihaza çizmek için DrawImage çağırırsanız, işlenen görüntünün piksel genişliği (216/72)*96 = 288 olur.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır

DrawImage(Image, Point[], Rectangle, GraphicsUnit, ImageAttributes)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
Kaynak:
Graphics.cs

Belirtilen konumda belirtilen Image belirtilen bölümünü çizer.

public:
 void DrawImage(System::Drawing::Image ^ image, cli::array <System::Drawing::Point> ^ destPoints, System::Drawing::Rectangle srcRect, System::Drawing::GraphicsUnit srcUnit, System::Drawing::Imaging::ImageAttributes ^ imageAttr);
public void DrawImage (System.Drawing.Image image, System.Drawing.Point[] destPoints, System.Drawing.Rectangle srcRect, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes? imageAttr);
public void DrawImage (System.Drawing.Image image, System.Drawing.Point[] destPoints, System.Drawing.Rectangle srcRect, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes imageAttr);
member this.DrawImage : System.Drawing.Image * System.Drawing.Point[] * System.Drawing.Rectangle * System.Drawing.GraphicsUnit * System.Drawing.Imaging.ImageAttributes -> unit
Public Sub DrawImage (image As Image, destPoints As Point(), srcRect As Rectangle, srcUnit As GraphicsUnit, imageAttr As ImageAttributes)

Parametreler

image
Image

Çizmek için Image.

destPoints
Point[]

Paralelkenar tanımlayan üç Point yapısı dizisi.

srcRect
Rectangle

Çizecek image nesnesinin bölümünü belirten Rectangle yapı.

srcUnit
GraphicsUnit

srcRect parametresi tarafından kullanılan ölçü birimlerini belirten GraphicsUnit numaralandırmasının üyesi.

imageAttr
ImageAttributes

image nesnesi için yeniden renklendirme ve gama bilgilerini belirten ImageAttributes.

Özel durumlar

image null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

  • Örneğin klasöründe SampImag.jpg bir JPEG dosyasından görüntü oluşturur.

  • Görüntüyü çizmek için bir paralelogram tanımlayan noktalar oluşturur.

  • Resmin çizecek bölümünü seçmek için bir dikdörtgen oluşturur.

  • Grafik çizim birimini piksel olarak ayarlar.

  • Özgün görüntüyü ekrana çizer.

  • Ayarlanmış bir görüntünün çizildiği ek bir paralelogram oluşturur.

  • Düzeltilmiş görüntünün özniteliklerini oluşturur ve her zamankinden daha büyük bir gama değerine sahip olacak şekilde ayarlar.

  • Ayarlanmış görüntüyü ekrana çizer.

Özgün, ayarsız paralel grafik için, konum görüntüyü ekranda bulur ve dikdörtgenin boyutu ile paralel grafiğin boyutu ve şekli, çizilen görüntünün ölçeklendirilip kırpılma durumunu belirler.

private:
   void DrawImageParaRectAttrib( PaintEventArgs^ e )
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create parallelogram for drawing image.
      Point ulCorner1 = Point(100,100);
      Point urCorner1 = Point(325,100);
      Point llCorner1 = Point(150,250);
      array<Point>^ destPara1 = {ulCorner1,urCorner1,llCorner1};

      // Create rectangle for source image.
      Rectangle srcRect = Rectangle(50,50,150,150);
      GraphicsUnit units = GraphicsUnit::Pixel;

      // Draw original image to screen.
      e->Graphics->DrawImage( newImage, destPara1, srcRect, units );

      // Create parallelogram for drawing adjusted image.
      Point ulCorner2 = Point(325,100);
      Point urCorner2 = Point(550,100);
      Point llCorner2 = Point(375,250);
      array<Point>^ destPara2 = {ulCorner2,urCorner2,llCorner2};

      // Create image attributes and set large gamma.
      ImageAttributes^ imageAttr = gcnew ImageAttributes;
      imageAttr->SetGamma( 4.0F );

      // Draw adjusted image to screen.
      e->Graphics->DrawImage( newImage, destPara2, srcRect, units, imageAttr );
   }
private void DrawImageParaRectAttrib(PaintEventArgs e)
{
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create parallelogram for drawing image.
    Point ulCorner1 = new Point(100, 100);
    Point urCorner1 = new Point(325, 100);
    Point llCorner1 = new Point(150, 250);
    Point[] destPara1 = {ulCorner1, urCorner1, llCorner1};
             
    // Create rectangle for source image.
    Rectangle srcRect = new Rectangle(50, 50, 150, 150);
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Draw original image to screen.
    e.Graphics.DrawImage(newImage, destPara1, srcRect, units);
             
    // Create parallelogram for drawing adjusted image.
    Point ulCorner2 = new Point(325, 100);
    Point urCorner2 = new Point(550, 100);
    Point llCorner2 = new Point(375, 250);
    Point[] destPara2 = {ulCorner2, urCorner2, llCorner2};
             
    // Create image attributes and set large gamma.
    ImageAttributes imageAttr = new ImageAttributes();
    imageAttr.SetGamma(4.0F);
             
    // Draw adjusted image to screen.
    e.Graphics.DrawImage(newImage, destPara2, srcRect, units, imageAttr);
}
Private Sub DrawImageParaRectAttrib(ByVal e As PaintEventArgs)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create parallelogram for drawing image.
    Dim ulCorner1 As New Point(100, 100)
    Dim urCorner1 As New Point(325, 100)
    Dim llCorner1 As New Point(150, 250)
    Dim destPara1 As Point() = {ulCorner1, urCorner1, llCorner1}

    ' Create rectangle for source image.
    Dim srcRect As New Rectangle(50, 50, 150, 150)
    Dim units As GraphicsUnit = GraphicsUnit.Pixel

    ' Draw original image to screen.
    e.Graphics.DrawImage(newImage, destPara1, srcRect, units)

    ' Create parallelogram for drawing adjusted image.
    Dim ulCorner2 As New Point(325, 100)
    Dim urCorner2 As New Point(550, 100)
    Dim llCorner2 As New Point(375, 250)
    Dim destPara2 As Point() = {ulCorner2, urCorner2, llCorner2}

    ' Create image attributes and set large gamma.
    Dim imageAttr As New ImageAttributes
    imageAttr.SetGamma(4.0F)

    ' Draw adjusted image to screen.
    e.Graphics.DrawImage(newImage, destPara2, srcRect, units, _
    imageAttr)
End Sub

Açıklamalar

destPoints parametresi paralelkenarın üç noktasını belirtir. Üç Point yapısı, paralelkenarın sol üst, sağ üst ve sol alt köşelerini temsil eder. Dördüncü nokta, paralelkenar oluşturmak için ilk üç noktadan elde edilir.

srcRect parametresi, çizecekimage nesnesinin dikdörtgen bir bölümünü belirtir. Bu bölüm ölçeklendirilir ve destPoints parametresi tarafından belirtilen paralelkenarın içine sığacak şekilde yamlanır.

Ayrıca bkz.

  • Görüntüleri, Bit Eşlemleri ve Meta Dosyaları

Şunlara uygulanır