Méthode IOleInPlaceFrame ::InsertMenus (oleidl.h)

  • Article

Permet au conteneur d’insérer des groupes de menus dans le menu composite à utiliser pendant la session sur place.

Syntaxe

HRESULT InsertMenus(
  [in]      HMENU                hmenuShared,
  [in, out] LPOLEMENUGROUPWIDTHS lpMenuWidths
);

Paramètres

[in] hmenuShared

Handle vers un menu vide.

[in, out] lpMenuWidths

Pointeur vers un tableau OLEMENUGROUPWIDTHS avec six éléments. Le conteneur remplit les éléments 0, 2 et 4 pour refléter le nombre d’éléments de menu qu’il a fournis dans les groupes de menus Fichier, Affichage et Fenêtre .

Valeur retournée

Cette méthode retourne S_OK en cas de réussite. Les autres valeurs de retour possibles sont les suivantes.

Code de retour Description
E_UNEXPECTED
 Une erreur inattendue s’est produite.

Remarques

Remarques aux appelants

Cette méthode est appelée par les applications objet lorsqu’elles sont activées pour la première fois. Ils l’appellent pour insérer leurs menus dans l’interface utilisateur au niveau du cadre.

L’application objet demande au conteneur d’ajouter ses menus au menu spécifié dans hmenuShared et de définir le nombre de groupes dans le tableau OLEMENUGROUPWIDTHS pointé par lpMenuWidths. L’application objet ajoute ensuite ses propres menus et nombres. Les objets peuvent appeler IOleInPlaceFrame ::InsertMenus autant de fois que nécessaire pour créer les menus composites. Le conteneur doit utiliser le handle de menu initial associé au menu composite pour tous les éléments de menu dans les menus déroulants.

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 oleidl.h

Voir aussi

IOleInPlaceFrame