CDefFolderMenu_Create2, fonction (shlobj_core.h)

Article
08/26/2023

Crée un menu contextuel pour un groupe sélectionné d’objets de dossier de fichiers.

Syntaxe

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
);

Paramètres

[in, optional] pidlFolder

Type : PCIDLIST_ABSOLUTE

Structure ITEMIDLIST pour le dossier parent. Cette valeur peut être NULL.

[in, optional] hwnd

Type : HWND

Handle de la fenêtre parente. Cette valeur peut être NULL.

cidl

Type : UINT

Nombre de structures ITEMIDLIST dans le tableau pointé vers apidl.

[in, optional] apidl

Type : PCUITEMID_CHILD_ARRAY*

Pointeur vers un tableau de structures ITEMIDLIST , un pour chaque élément sélectionné.

[in, optional] psf

Type : IShellFolder*

Pointeur vers l’interface IShellFolder du dossier parent. Ce IShellFolder doit prendre en charge l’interface IDataObject . Si ce n’est pas le cas, CDefFolderMenu_Create2 échoue et retourne E_NOINTERFACE. Cette valeur peut être NULL.

[in, optional] pfn

Type : LPFNDFMCALLBACK

Objet de rappel LPFNDFMCALLBACK . Cette valeur peut être NULL si l’objet de rappel n’est pas nécessaire.

nKeys

Type : UINT

Nombre de clés de Registre dans le tableau pointé par ahkeys.

Note Le nombre maximal de clés de Registre est de 16. Les appelants doivent appliquer cette limite, ce qui n’est pas le cas de l’API. Si vous ne le faites pas, la mémoire peut être endommagée.

[in, optional] ahkeys

Type : const HKEY*

Pointeur vers un tableau de clés de Registre qui spécifie les gestionnaires de menu contextuels utilisés avec les entrées du menu. Pour plus d’informations sur les gestionnaires de menus contextuels, consultez Création de gestionnaires de menus contextuels. Ce tableau peut contenir un maximum de 16 clés de Registre.

[out] ppcm

Type : IContextMenu**

Adresse d’un pointeur d’interface IContextMenu qui, lorsque cette fonction retourne correctement, pointe vers l’objet IContextMenu qui représente le menu contextuel.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h (inclure Shlobj.h)
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 5.00 ou ultérieure)

Voir aussi

SHCreateDefaultContextMenu

Partager via