CDefFolderMenu_Create2, fonction (shlobj_core.h)

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.

[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

Voir aussi

SHCreateDefaultContextMenu