IContextMenu3::Metode HandleMenuMsg2 (shobjidl_core.h)

Artikel
03/02/2024

Memungkinkan objek klien antarmuka IContextMenu3 menangani pesan yang terkait dengan item menu yang digambar pemilik.

Sintaks

HRESULT HandleMenuMsg2(
  UINT    uMsg,
  WPARAM  wParam,
  LPARAM  lParam,
  LRESULT *plResult
);

Parameter

uMsg

Jenis: UINT

Pesan yang akan diproses. Dalam kasus beberapa pesan, seperti WM_INITMENUPOPUP, WM_DRAWITEM, WM_MENUCHAR, atau WM_MEASUREITEM, objek klien yang dipanggil dapat menyediakan item menu yang digambar pemilik.

wParam

Jenis: WPARAM

Informasi pesan tambahan. Nilai parameter ini tergantung pada nilai parameter uMsg .

lParam

Jenis: LPARAM

Informasi pesan tambahan. Nilai parameter ini tergantung pada nilai parameter uMsg .

plResult

Jenis: LRESULT*

Alamat nilai LRESULT yang akan dikembalikan pemilik menu dari pesan. Parameter ini bisa NULL.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

IContextMenu3::HandleMenuMsg2 umumnya menggantikan IContextMenu2::HandleMenuMsg, dan dipanggil ketika IContextMenu menentukan bahwa IContextMenu3 didukung dan salah satu pesan yang didukung (lihat uMsg) telah diterima. Namun, dalam beberapa kasus, IContextMenu2::HandleMenuMsg masih dipanggil. Host menu konteks dapat mengirimkan pesan menu melalui salah satu atau kedua metode. Akibatnya, jika ekstensi Shell mengimplementasikan IContextMenu2::HandleMenuMsg dan IContextMenu3::HandleMenuMsg2, harus disiapkan agar pesan menu tiba melalui salah satu metode.

Catatan Jika IContextMenu3 tidak diimplementasikan, tidak ada jaminan bahwa IContextMenu2 akan dipanggil sebagai gantinya. Dalam beberapa kasus, tidak adanya IContextMenu3 ditentukan dan kemudian proses dihentikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
DLL	Shell32.dll (versi 4.71 atau yang lebih baru)

Bagikan melalui