IContextMenu2::Metode HandleMenuMsg (shobjidl_core.h)

Artikel
08/26/2023

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

Sintaks

HRESULT HandleMenuMsg(
  UINT   uMsg,
  WPARAM wParam,
  LPARAM lParam
);

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 .

Nilai kembali

Jenis: HRESULT

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

Keterangan

IContextMenu2::HandleMenuMsg umumnya digantikan oleh HandleMenuMsg2. HandleMenuMsg2 dipanggil ketika IContextMenu menentukan bahwa IContextMenu3 didukung dan menerima salah satu pesan yang ditentukan dalam deskripsi parameter uMsg . Namun, dalam beberapa kasus, IContextMenu2::HandleMenuMsg masih dipanggil.

Jika IContextMenu2 atau IContextMenu3 diperlukan, implementasi terbaik untuk menu konteks baru adalah menerapkan semua logika mereka di HandleMenuMsg2 dan memiliki implementasi IContextMenu2::HandleMenuMsg hanya mendelegasikan panggilan ke HandleMenuMsg2 dan meneruskan NULL sebagai parameter plResult .

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


Klien minimum yang didukung	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.0 atau yang lebih baru)

Lihat juga

HandleMenuMsg2

IContextMenu2

Bagikan melalui