fungsi CDefFolderMenu_Create2 (shlobj_core.h)

Artikel
08/26/2023

Membuat menu konteks untuk sekelompok objek folder file yang dipilih.

Sintaks

SHSTDAPI CDefFolderMenu_Create2(
  [in, optional] PCIDLIST_ABSOLUTE     pidlFolder,
  [in, optional] HWND                  hwnd,
                 UINT                  cidl,
  [in, optional] PCUITEMID_CHILD_ARRAY apidl,
  [in, optional] IShellFolder          *psf,
  [in, optional] LPFNDFMCALLBACK       pfn,
                 UINT                  nKeys,
  [in, optional] const HKEY            *ahkeys,
  [out]          IContextMenu          **ppcm
);

Parameter

[in, optional] pidlFolder

Jenis: PCIDLIST_ABSOLUTE

Struktur ITEMIDLIST untuk folder induk. Nilai ini bisa NULL.

[in, optional] hwnd

Jenis: HWND

Handel ke jendela induk. Nilai ini bisa NULL.

cidl

Jenis: UINT

Jumlah struktur ITEMIDLIST dalam array yang ditujukkan oleh apidl.

[in, optional] apidl

Jenis: PCUITEMID_CHILD_ARRAY*

Penunjuk ke array struktur ITEMIDLIST , satu untuk setiap item yang dipilih.

[in, optional] psf

Jenis: IShellFolder*

Penunjuk ke antarmuka IShellFolder folder induk. IShellFolder ini harus mendukung antarmuka IDataObject. Jika tidak, CDefFolderMenu_Create2 gagal dan mengembalikan E_NOINTERFACE. Nilai ini bisa NULL.

[in, optional] pfn

Jenis: LPFNDFMCALLBACK

Objek panggilan balik LPFNDFMCALLBACK . Nilai ini bisa NULL jika objek panggilan balik tidak diperlukan.

nKeys

Jenis: UINT

Jumlah kunci registri dalam array yang ditujukkan oleh ahkeys.

Catatan Jumlah maksimum kunci registri adalah 16. Penelepon harus memberlakukan batas ini karena API tidak berlaku. Gagal melakukannya dapat mengakibatkan kerusakan memori.

[in, optional] ahkeys

Jenis: const HKEY*

Penunjuk ke array kunci registri yang menentukan penangan menu konteks yang digunakan dengan entri menu. Untuk informasi selengkapnya tentang penangan menu konteks, lihat Membuat Penangan Menu Konteks. Array ini dapat berisi maksimum 16 kunci registri.

[out] ppcm

Jenis: IContextMenu**

Alamat penunjuk antarmuka IContextMenu yang, ketika fungsi ini berhasil dikembalikan, menunjuk ke objek IContextMenu yang mewakili menu konteks.

Menampilkan nilai

Jenis: HRESULT

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

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj_core.h (termasuk Shlobj.h)
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 5.00 atau yang lebih baru)

Lihat juga

SHCreateDefaultContextMenu

Share via