Grafis::Metode GetHDC (gdiplusgraphics.h)

Artikel
08/24/2023

Metode Graphics::GetHDC mendapatkan handel ke konteks perangkat yang terkait dengan objek Grafis ini.

Sintaks

HDC GetHDC();

Mengembalikan nilai

Jenis: HDC

Metode ini mengembalikan handel ke konteks perangkat yang terkait dengan objek Grafis ini.

Keterangan

Setiap panggilan ke metode Grafis::GetHDC dari objek Grafis harus dipasangkan dengan panggilan ke metode Graphics::ReleaseHDC dari objek Grafis yang sama. Jangan panggil metode apa pun dari objek Grafis antara panggilan ke Grafis::GetHDC dan Grafis::ReleaseHDC. Jika Anda mencoba memanggil metode objek Grafis antara Graphics::GetHDC dan Graphics::ReleaseHDC, metode akan gagal dan akan mengembalikan ObjectBusy.

Setiap perubahan status yang Anda buat pada konteks perangkat antara Grafis::GetHDC dan Grafis::ReleaseHDC akan diabaikan oleh GDI+ dan tidak akan tercermin dalam penyajian yang dilakukan oleh GDI+.

Contoh

Fungsi berikut menggunakan GDI+ untuk menggambar elips, lalu menggunakan GDI untuk menggambar persegi panjang, dan akhirnya menggunakan GDI+ untuk menggambar garis. Satu parameter fungsi adalah penunjuk ke objek Grafis GDI + . Kode memanggil metode Graphics::D rawEllipse dari objek Grafis tersebut untuk menggambar elips . Selanjutnya, kode memanggil metode Graphics::GetHDC untuk mendapatkan handel ke konteks perangkat yang terkait dengan objek Grafis . Kode menggambar persegi panjang dengan meneruskan handel konteks perangkat ke fungsi Persegi GDI. Kode memanggil metode Graphics::ReleaseHDC dari objek Grafis lalu menggunakan objek Grafis untuk menggambar garis.

VOID Example_GetReleaseHDC(Graphics* g)
{
   Pen pen(Color(255, 0, 0, 255));
   g->DrawEllipse(&pen, 10, 10, 100, 50);  // GDI+
   
   HDC hdc = g->GetHDC();
   
      // Make GDI calls, but don't call any methods
      // on g until after the call to ReleaseHDC.
      Rectangle(hdc, 120, 10, 220, 60);  // GDI  
   g->ReleaseHDC(hdc);
   
   // Ok to call methods on g again.
   g->DrawLine(&pen, 240, 10, 340, 60);  
}

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

Lihat juga

Perubahan dalam Model Pemrograman