Metode IOleInPlaceSiteWindowless::OnDefWindowMessage (ocidl.h)

Artikel
03/13/2024

Memanggil pemrosesan default untuk semua pesan yang diteruskan ke objek.

Sintaks

HRESULT OnDefWindowMessage(
  [in]  UINT    msg,
  [in]  WPARAM  wParam,
  [in]  LPARAM  lParam,
  [out] LRESULT *plResult
);

Parameter

[in] msg

Pengidentifikasi untuk pesan jendela yang disediakan untuk kontainer oleh Windows.

[in] wParam

Parameter untuk pesan jendela yang disediakan untuk kontainer oleh Windows.

[in] lParam

Parameter untuk pesan jendela yang disediakan untuk kontainer oleh Windows.

[out] plResult

Penunjuk ke kode hasil untuk pesan jendela.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan. Nilai pengembalian lain yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
S_FALSE	Pemrosesan default kontainer untuk pesan jendela tidak dipanggil. Lihat Catatan untuk Pelaksana di bawah ini.

Keterangan

Objek tanpa jendela dapat secara eksplisit memanggil pemrosesan default untuk pesan jendela dengan memanggil metode ini. Kontainer mengirimkan pesan jendela ke objek tanpa jendelanya dengan memanggil IOleInPlaceObjectWindowless::OnWindowMessage. Objek biasanya mengembalikan S_FALSE untuk menunjukkan bahwa objek tidak memproses pesan. Kemudian, kontainer dapat melakukan perilaku default untuk pesan dengan memanggil fungsi DefWindowProc .

Sebagai gantinya, objek dapat memanggil metode ini pada objek situs kontainer untuk secara eksplisit memanggil pemrosesan default. Kemudian, objek dapat mengambil tindakan sendiri jika kontainer tidak menangani pesan.

Catatan untuk Pelaksana

Kontainer harus meneruskan pesan jendela berikut ke prosedur jendela defaultnya (fungsi DefWindowProc ) dan mengembalikan S_OK. Perhatikan bahwa *plResult harus berisi nilai yang dikembalikan oleh DefWindowProc.

WM_CHAR
WM_DEADCHAR
WM_IMExxx
WM_KEYDOWN
WM_KEYUP
WM_MOUSEMOVE
WM_SYSCHAR
WM_SYSDEADCHAR
WM_SYSKEYUP
WM_XBUTTONDOWN
WM_XBUTTONUP
WM_XBUTTONDBLCLK

Kontainer dapat memproses pesan jendela sebagai miliknya sendiri dan mengembalikan S_OK atau tidak melakukan apa pun dan mengembalikan S_FALSE.

WM_CONTEXTMENU
WM_HELP
WM_SETCURSOR

Jika kontainer mengembalikan S_FALSE, objek dapat mengambil tindakan untuk memproses pesan jendela sendiri.

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	ocidl.h

Lihat juga

IOleInPlaceObjectWindowless::OnWindowMessage

IOleInPlaceSiteWindowless

Bagikan melalui