Grafis::D rawImage(Image,constRectF&,REAL,REAL,REAL,REAL,Unit,constImageAttributes,DrawImageAbort,VOID*) metode (gdiplusgraphics.h)

Artikel
08/24/2023

Metode Graphics::D rawImage menggambar gambar.

Sintaks

Status DrawImage(
  [in]      Image                 *image,
  [in, ref] const RectF &         destRect,
  [in]      REAL                  srcx,
  [in]      REAL                  srcy,
  [in]      REAL                  srcwidth,
  [in]      REAL                  srcheight,
  [in]      Unit                  srcUnit,
  [in]      const ImageAttributes *imageAttributes,
  [in]      DrawImageAbort        callback,
  [in]      VOID                  *callbackData
);

Parameter

[in] image

Jenis: Gambar*

Penunjuk ke objek Gambar yang menentukan gambar sumber.

[in, ref] destRect

Jenis: const RectF

Referensi ke persegi panjang yang mengikat area gambar untuk gambar.

[in] srcx

Jenis: NYATA

Angka riil yang menentukan koordinat x dari sudut kiri atas bagian gambar sumber yang akan digambar.

[in] srcy

Jenis: NYATA

Angka riil yang menentukan koordinat y dari sudut kiri atas bagian gambar sumber yang akan digambar.

[in] srcwidth

Jenis: NYATA

Angka riil yang menentukan lebar bagian gambar sumber yang akan digambar.

[in] srcheight

Jenis: NYATA

Angka riil yang menentukan tinggi bagian gambar sumber yang akan digambar.

[in] srcUnit

Jenis: Unit

Elemen enumerasi Unit yang menentukan satuan pengukuran untuk gambar. Nilai defaultnya adalah UnitPixel.

[in] imageAttributes

Jenis: ImageAttributes*

Penunjuk ke objek ImageAttributes yang menentukan atribut warna dan ukuran gambar yang akan digambar. Nilai defaultnya adalah NULL.

[in] callback

Jenis: DrawImageAbort

Metode panggilan balik yang digunakan untuk membatalkan gambar yang sedang berlangsung. Nilai defaultnya adalah NULL.

[in] callbackData

Jenis: VOID*

Penunjuk ke data tambahan yang digunakan oleh metode yang ditentukan oleh parameter panggilan balik . Nilai defaultnya adalah NULL.

Mengembalikan nilai

Jenis: Status

Jika metode berhasil, metode mengembalikan Ok, yang merupakan elemen dari enumerasi Status .

Jika metode gagal, metode mengembalikan salah satu elemen lain dari enumerasi Status .

Keterangan

Bagian gambar sumber yang akan digambar diskalakan agar pas dengan persegi panjang.

Contoh

Contoh berikut menggambar gambar sumber asli lalu menggambar sebagian gambar dalam persegi panjang tertentu.

VOID Example_DrawImage6(HDC hdc)

{

   Graphics graphics(hdc);



   // Create an Image object.

   Image image(L"pattern.png");



   // Draw the original source image.

   graphics.DrawImage(&image, 10, 10);



   // Define the portion of the image to draw.

   REAL srcX = 70.0f;

   REAL srcY = 20.0f;

   REAL srcWidth = 100.0f;

   REAL srcHeight = 100.0f;



   // Create a RectF object that specifies the destination of the image.

   RectF destRect(200.0f, 10.0f, <REAL>image.GetWidth(), <REAL>image.GetHeight());

   

   // Create an ImageAttributes object that specifies a recoloring from red to blue.

   ImageAttributes remapAttributes;

   ColorMap redToBlue;

   redToBlue.oldColor = Color(255, 255, 0, 0);

   redToBlue.newColor = Color(255, 0, 0, 255);

   remapAttributes.SetRemapTable(1, &redToBlue);



   // Draw the resized image.

   graphics.DrawImage(

   &image,

   destRect,

   srcX,

   srcY,

   srcWidth,

   srcHeight,

   UnitPixel,

   &remapAttributes,

   NULL,

   NULL);

}

Ilustrasi berikut menunjukkan output kode sebelumnya.

Ilustrasi memperlihatkan dua grafik: pola kotak-kotak multiwarna, lalu pembekuan dua-kencang dari pola itu

Persyaratan


Klien minimum yang didukung	Windows XP, Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	gdiplusgraphics.h (termasuk Gdiplus.h)
Pustaka	Gdiplus.lib
DLL	Gdiplus.dll