IShellBrowser::SetMenuSB

Quick Info

Windows NT
Yes
Win95
Yes
Win32s
No
Import Library
-
Header File
shlobj.h
Unicode
No
Platform Notes
None

[Now Supported on Windows NT]

Installs the composite menu in the view window. Similar to IOleInPlaceFrame::SetMenu.

RESULT SetMenuSB(

HMENU hmenuShared,	// A handle to the composite menu
HOLEMENU holemenuReserved	// Reserved for future use
);

Parameters
hmenuShared
Specifiies a handle to the composite menu constructed by calls to IShellBrowser::InsertMenusSB and the Win32 InsertMenu function.

holemenuReserved
Reserved for future use.

Return Values
Returns NOERROR if successful or an OLE-defined error value otherwise.

Remarks
This method is similar to IOleInPlaceFrame::SetMenu. However, the Explorer performs menu dispatch based on the menu item ID.

The availability of specific menu items depends on whether the view has the focus. Accordingly, it is necessary to call IShellBrowser::OnViewWindowActive whenever the view window (or one of it's child windows) has the focus.

Notes to Callers
The object calls IShellBrowser::SetMenuSB to ask the container to install the composite menu structure set up by calls to IShellBrowser::InsertMenusSB.

Notes to Implementers
A container's implementation of this method should call the Windows SetMenu function.