Fungsi PeekMessageW (winuser.h)

Mengirimkan pesan masuk yang tidak diantrekan, memeriksa antrean pesan utas untuk pesan yang diposting, dan mengambil pesan (jika ada).

Sintaksis

BOOL PeekMessageW(
  [out]          LPMSG lpMsg,
  [in, optional] HWND  hWnd,
  [in]           UINT  wMsgFilterMin,
  [in]           UINT  wMsgFilterMax,
  [in]           UINT  wRemoveMsg
);

Parameter

[out] lpMsg

Jenis: LPMSG

Penunjuk ke struktur MSG yang menerima informasi pesan.

[in, optional] hWnd

Jenis: HWND

Handel ke jendela yang pesannya akan diambil. Jendela harus milik utas saat ini.

Jika hWnd null, PeekMessage mengambil pesan untuk jendela apa pun yang termasuk dalam utas saat ini, dan pesan apa pun pada antrean pesan utas saat ini yang nilai null (lihat struktur MSG). Oleh karena itu jika hWnd NULL, pesan jendela dan pesan utas diproses.

Jika hWnd adalah -1, PeekMessage hanya mengambil pesan pada antrean pesan utas saat ini yang nilai hwnd null, yaitu, pesan utas seperti yang diposting oleh PostMessage (saat parameter hWnd null) atau PostThreadMessage.

[in] wMsgFilterMin

Jenis: UINT

Nilai pesan pertama dalam rentang pesan yang akan diperiksa. Gunakan WM_KEYFIRST (0x0100) untuk menentukan pesan keyboard pertama atau WM_MOUSEFIRST (0x0200) untuk menentukan pesan mouse pertama.

Jika wMsgFilterMin dan wMsgFilterMax keduanya nol, PeekMessage mengembalikan semua pesan yang tersedia (artinya, tidak ada pemfilteran rentang yang dilakukan).

[in] wMsgFilterMax

Jenis: UINT

Nilai pesan terakhir dalam rentang pesan yang akan diperiksa. Gunakan WM_KEYLAST untuk menentukan pesan keyboard terakhir atau WM_MOUSELAST untuk menentukan pesan mouse terakhir.

Jika wMsgFilterMin dan wMsgFilterMax keduanya nol, PeekMessage mengembalikan semua pesan yang tersedia (artinya, tidak ada pemfilteran rentang yang dilakukan).

[in] wRemoveMsg

Jenis: UINT

Menentukan bagaimana pesan akan ditangani. Parameter ini bisa berupa satu atau beberapa nilai berikut.

Secara default, semua jenis pesan diproses. Untuk menentukan bahwa hanya pesan tertentu yang harus diproses, tentukan satu atau beberapa nilai berikut.

Untuk informasi selengkapnya tentang bendera dan jenis pesan QS_ yang tercantum, lihat dokumentasi GetQueueStatus.

Mengembalikan nilai

Jenis: BOOL

Jika pesan tersedia, nilai yang dikembalikan bukan nol.

Jika tidak ada pesan yang tersedia, nilai yang dikembalikan adalah nol.

Komentar

PeekMessage mengambil pesan yang terkait dengan jendela yang diidentifikasi oleh parameter hWnd atau salah satu turunannya seperti yang ditentukan oleh fungsi IsChild, dan dalam rentang nilai pesan yang diberikan oleh wMsgFilterMin dan parameter wMsgFilterMax. Perhatikan bahwa aplikasi hanya dapat menggunakan kata rendah dalam parameter wMsgFilterMin dan wMsgFilterMax; kata tinggi dicadangkan untuk sistem.

Perhatikan bahwa PeekMessage selalu mengambil pesan WM_QUIT, apa pun nilai yang Anda tentukan untuk wMsgFilterMin dan wMsgFilterMax.

Selama panggilan ini, sistem mengirimkan (DispatchMessage) tertunda, pesan yang tidak diantrekan, yaitu, pesan yang dikirim ke jendela yang dimiliki oleh utas panggilan menggunakanSendMessage , sendMessageCallback, SendMessageTimeout, , atau fungsi SendNotifyMessage. Kemudian pesan antrean pertama yang cocok dengan filter yang ditentukan diambil. Sistem juga dapat memproses peristiwa internal. Jika tidak ada filter yang ditentukan, pesan diproses dalam urutan berikut:

• Pesan terkirim
• Pesan yang diposting
• Pesan input (perangkat keras) dan peristiwa internal sistem
• Pesan terkirim (lagi)
• pesan WM_PAINT
• WM_TIMER pesan