OleSetMenuDescriptor, fonction (ole2.h)
Installe ou supprime le code de distribution OLE de la fenêtre frame du conteneur.
Syntaxe
HRESULT OleSetMenuDescriptor(
[in] HOLEMENU holemenu,
[in] HWND hwndFrame,
[in] HWND hwndActiveObject,
[in] LPOLEINPLACEFRAME lpFrame,
[in] LPOLEINPLACEACTIVEOBJECT lpActiveObj
);
Paramètres
[in] holemenu
Handle vers le descripteur de menu composite retourné par la fonction OleCreateMenuDescriptor . Si la valeur est NULL, le code de distribution est déconnecté.
[in] hwndFrame
Gérez vers la fenêtre frame du conteneur où le menu composite sur place doit être installé.
[in] hwndActiveObject
Gérez vers la fenêtre d’activation sur place de l’objet. OLE distribue les messages de menu et les commandes à cette fenêtre.
[in] lpFrame
Pointeur vers l’interface IOleInPlaceFrame dans la fenêtre frame du conteneur.
[in] lpActiveObj
Pointeur vers l’interface IOleInPlaceActiveObject sur l’objet actif sur place.
Valeur retournée
Cette fonction retourne S_OK en cas de réussite.
Remarques
Le conteneur doit appeler OleSetMenuDescriptor pour installer le code de distribution sur hwndFrame lorsque l’objet appelle la méthode IOleInPlaceFrame ::SetMenu , ou pour supprimer le code de distribution en passant NULL comme valeur de holemenu à OleSetMenuDescriptor.
Si les paramètres lpFrame et lpActiveObj ne sont pas NULL, OLE installe le filtre de message F1 d’aide contextuelle pour l’application. Sinon, l’application doit fournir son propre filtre de messages.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | ole2.h |
| Bibliothèque | Ole32.lib |
| DLL | Ole32.dll |
| Ensemble d’API | ext-ms-win-com-ole32-l1-1-5 (introduit dans Windows 10, version 10.0.15063) |