Fungsi panggilan balik MONITORENUMPROC (winuser.h)

Fungsi MonitorEnumProc adalah fungsi panggilan balik yang ditentukan aplikasi yang dipanggil oleh fungsi EnumDisplayMonitors .

Nilai jenis MONITORENUMPROC adalah penunjuk ke fungsi MonitorEnumProc .

Sintaks

MONITORENUMPROC Monitorenumproc;

BOOL Monitorenumproc(
  HMONITOR unnamedParam1,
  HDC unnamedParam2,
  LPRECT unnamedParam3,
  LPARAM unnamedParam4
)
{...}

Parameter

unnamedParam1

Handel ke monitor tampilan. Nilai ini akan selalu non-NULL.

unnamedParam2

Handel ke konteks perangkat.

Konteks perangkat memiliki atribut warna yang sesuai untuk monitor tampilan yang diidentifikasi oleh hMonitor. Area kliping konteks perangkat diatur ke persimpangan wilayah yang terlihat dari konteks perangkat yang diidentifikasi oleh parameter hdcEnumDisplayMonitors, persegi panjang yang ditunjukkan oleh parameter lprcClip dari EnumDisplayMonitors, dan persegi panjang monitor tampilan.

Nilai ini adalah NULL jika parameter hdcEnumDisplayMonitors adalah NULL.

unnamedParam3

Penunjuk ke struktur RECT .

Jika hdcMonitornon-NULL, persegi panjang ini adalah persimpangan area kliping konteks perangkat yang diidentifikasi oleh hdcMonitor dan persegi panjang monitor tampilan. Koordinat persegi panjang adalah koordinat konteks perangkat.

Jika hdcMonitor adalah NULL, persegi panjang ini adalah persegi panjang monitor tampilan. Koordinat persegi panjang adalah koordinat layar virtual.

unnamedParam4

Data yang ditentukan aplikasi yang diteruskan EnumDisplayMonitors langsung ke fungsi enumerasi.

Mengembalikan nilai

Untuk melanjutkan enumerasi, kembalikan TRUE.

Untuk menghentikan enumerasi, kembalikan FALSE.

Keterangan

Anda dapat menggunakan fungsi EnumDisplayMonitors untuk menghitung kumpulan monitor tampilan yang berpotongan dengan wilayah yang terlihat dari konteks perangkat tertentu dan, secara opsional, persegi panjang kliping. Untuk melakukan ini, atur parameter hdc ke nilai non-NULL , dan atur parameter lprcClip sesuai kebutuhan.

Anda juga dapat menggunakan fungsi EnumDisplayMonitors untuk menghitung satu atau beberapa monitor tampilan di desktop, tanpa menyediakan konteks perangkat. Untuk melakukan ini, atur parameter hdcEnumDisplayMonitors ke NULL dan atur parameter lprcClip sesuai kebutuhan.

Dalam semua kasus, EnumDisplayMonitors memanggil fungsi MonitorEnumProc tertentu sekali untuk setiap monitor tampilan dalam kumpulan enumerasi terhitung. Fungsi MonitorEnumProc selalu menerima handel ke monitor tampilan.

Jika parameter hdcEnumDisplayMonitorsnon-NULL, fungsi MonitorEnumProc juga menerima handel ke konteks perangkat yang format warnanya sesuai untuk monitor tampilan. Anda kemudian dapat melukis ke dalam konteks perangkat dengan cara yang optimal untuk monitor tampilan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header winuser.h (sertakan Windows.h)

Lihat juga

EnumDisplayMonitors

Fungsi Monitor Beberapa Tampilan

Gambaran Umum Monitor Beberapa Tampilan