Méthode IShellBrowser ::SetMenuSB (shobjidl_core.h)

Installe le menu composite dans la fenêtre d’affichage.

Syntaxe

HRESULT SetMenuSB(
  HMENU    hmenuShared,
  HOLEMENU holemenuRes,
  HWND     hwndActiveObject
);

Paramètres

hmenuShared

Type : HMENU

Handle du menu composite construit par les appels à IShellBrowser ::InsertMenusSB et à la fonction InsertMenu .

holemenuRes

Type : HOLEMENU

hwndActiveObject

Type : HWND

Handle de fenêtre de la vue.

Valeur retournée

Type : RESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur définie par COM dans le cas contraire.

Remarques

Cette méthode est similaire à la méthode IOleInPlaceFrame ::SetMenu . Toutefois, Windows Explorer effectue la répartition des menus en fonction de l’identificateur de l’élément de menu.

La disponibilité d’éléments de menu spécifiques varie selon que l’affichage a le focus. Par conséquent, il est nécessaire d’appeler la méthode IShellBrowser ::OnViewWindowActive chaque fois que la fenêtre d’affichage (ou l’une de ses fenêtres enfants) a le focus.

Remarques relatives à l’appel d’applications

L’objet appelle IShellBrowser_SetMenuSB pour demander au conteneur d’installer la structure de menu composite configurée par les appels à IShellBrowser ::InsertMenusSB.

Remarques aux implémenteurs

L’implémentation de cette méthode par un conteneur doit appeler la fonction SetMenu .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (incluez Shobjidl.h)
DLL Shell32.dll (version 4.0 ou ultérieure)

Voir aussi

IShellBrowser