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.

C#
public void DrawImage (System.Drawing.Image image, float x, float y, System.Drawing.RectangleF srcRect, System.Drawing.GraphicsUnit srcUnit);

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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
C#
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);

Parametreler

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

Şunlara uygulanır

.NET 9 ve Windows Desktop 9
Ürün Sürümler
.NET 9
Windows Desktop 9

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.

C#
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);
C#
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);

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.

C#

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
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);
C#
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);

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.

C#

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
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);
C#
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);

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.

C#

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
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);
C#
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);

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.

C#

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
public void DrawImage (System.Drawing.Image image, System.Drawing.Rectangle destRect, int srcX, int srcY, int srcWidth, int srcHeight, System.Drawing.GraphicsUnit srcUnit);

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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
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);
C#
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);

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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
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);
C#
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);

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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
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);
C#
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);

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.

C#

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
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);
C#
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);

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.

C#

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
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);
C#
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);

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

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.

C#

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
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);
C#
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);

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

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.

C#

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
public void DrawImage (System.Drawing.Image image, System.Drawing.Rectangle destRect, float srcX, float srcY, float srcWidth, float srcHeight, System.Drawing.GraphicsUnit srcUnit);

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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

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

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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
public void DrawImage (System.Drawing.Image image, float x, float y, float width, float height);

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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
public void DrawImage (System.Drawing.Image image, System.Drawing.PointF[] destPoints, System.Drawing.RectangleF srcRect, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes? imageAttr);
C#
public void DrawImage (System.Drawing.Image image, System.Drawing.PointF[] destPoints, System.Drawing.RectangleF srcRect, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes imageAttr);

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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

DrawImage(Image, Effect)

Kaynak:
Graphics.cs
Kaynak:
Graphics.cs
C#
public void DrawImage (System.Drawing.Image image, System.Drawing.Imaging.Effects.Effect effect);

Parametreler

image
Image
effect
Effect

Şunlara uygulanır

.NET 9 ve Windows Desktop 9
Ürün Sürümler
.NET 9
Windows Desktop 9

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.

C#
public void DrawImage (System.Drawing.Image image, System.Drawing.Point 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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
public void DrawImage (System.Drawing.Image image, System.Drawing.Point[] destPoints);

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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
public void DrawImage (System.Drawing.Image image, System.Drawing.PointF point);

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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
public void DrawImage (System.Drawing.Image image, System.Drawing.PointF[] destPoints);

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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
public void DrawImage (System.Drawing.Image image, System.Drawing.Rectangle rect);

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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
public void DrawImage (System.Drawing.Image image, System.Drawing.RectangleF rect);

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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
public void DrawImage (System.Drawing.Image image, int x, int y, System.Drawing.Rectangle srcRect, System.Drawing.GraphicsUnit srcUnit);

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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
public void DrawImage (System.Drawing.Image image, float x, float y);

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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
public void DrawImage (System.Drawing.Image image, System.Drawing.Point[] destPoints, System.Drawing.Rectangle srcRect, System.Drawing.GraphicsUnit srcUnit);

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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
public void DrawImage (System.Drawing.Image image, System.Drawing.PointF[] destPoints, System.Drawing.RectangleF srcRect, System.Drawing.GraphicsUnit srcUnit);

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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
public void DrawImage (System.Drawing.Image image, System.Drawing.Rectangle destRect, System.Drawing.Rectangle srcRect, System.Drawing.GraphicsUnit srcUnit);

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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
public void DrawImage (System.Drawing.Image image, System.Drawing.RectangleF destRect, System.Drawing.RectangleF srcRect, System.Drawing.GraphicsUnit srcUnit);

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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
public void DrawImage (System.Drawing.Image image, int x, int y);

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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
public void DrawImage (System.Drawing.Image image, System.Drawing.Point[] destPoints, System.Drawing.Rectangle srcRect, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes? imageAttr);
C#
public void DrawImage (System.Drawing.Image image, System.Drawing.Point[] destPoints, System.Drawing.Rectangle srcRect, System.Drawing.GraphicsUnit srcUnit, System.Drawing.Imaging.ImageAttributes imageAttr);

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.

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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9