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

Voir aussi

IOleInPlaceActiveObject

IOleInPlaceFrame ::SetMenu

OleCreateMenuDescriptor