IShellBrowser

The IShellBrowser interface provides services for namespace extensions and is the companion to the IShellView interface implemented by namespace extensions.. It is similar to the "site" interfaces that are often found in OLE hosting scenarios, such as IOleControl and IOleControlSite. This allows the extension to communicate with the host of the namespace, providing UI elements like menus, status text, and tool bars. This interface also provides the extension with a way to access storage to save its persistent view state.

IShellBrowser derives from IOleWindow and it represents the container's top-level window, allowing the contained views to insert their menus into the composite menu, install the composite menu into the appropriate window frame and remove the container's menu elements from the composite menu. It sets and displays status text relevant to the in-place object. It also enables or disables the frame's modeless dialog boxes, and translates accelerator keystrokes intended for the container's frame.

When to Implement

You do not implement this interface directly. IShellBrowser is implemented by the Windows Explorer and by the Windows File Open Dialog.

When to Use

When implementing a namespace extension, notably IShellView, you will use the IShellBrowser implementation that is passed to use IShellBrowser::CreateViewWindow to communicate with the Explorer.

Methods in Vtable Order

IUnknown Methods	Description
QueryInterface	Returns pointers to supported interfaces.
AddRef	Increments reference count.
Release	Decrements reference count.

IOleWindow Methods	Description
GetWindow	Returns a handle to one of the windows participating in in-place activation.
ContextSensitiveHelp	Determines whether context-sensitive help mode should be entered during an in-place activation session.

IShellBrowser Methods	Description
InsertMenusSB	Inserts the Explorer's menu items to an empty menu created by the view.
SetMenuSB	Installs the composite menu in the Explorer.
RemoveMenusSB	Gives the container a chance to remove its items from a composite menu. It perform tasks that are the opposite of InsertMenuSB.
SetStatusTextSB	Sets and displays status text in the Explorer window.
EnableModelessSB	Enables or disables modeless windows of the Explorer, such as a floating toolbar.
TranslateAcceleratorSB	Reserved for future use.
BrowseObject	Tells the Explorer to browse in another folder.
GetViewStateStream	Returns a view-specific stream that can be used to read and write the persistent data for a view.
GetControlWindow	Gets the window handle of an Explorer control.
SendControlMsg	Sends messages to Explorer controls.
QueryActiveShellView	Returns the currently activated (displayed) shellview object.
OnViewWindowActive	Informs the Explorer that the view was activated.
SetToolbarItems	Adds toolbar items to the Explorer's toolbar.

Software for developers

Delphi Components
.Net Components
Software for Android Developers

More information resources

MegaDetailed.Net
Unix Manual Pages
Delphi Examples

Databases for Amazon shops developers

Amazon Categories Database
Browse Nodes Database