Contents Index Topic Contents | ||
Previous Topic: IReconcileInitiator::SetProgressFeedback Next Topic: IShellBrowser::BrowseObject |
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 situations, such as the IOleControl and IOleControlSite interfaces. This allows the extension to communicate with the host of the namespace by 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 the IOleWindow interface, and it represents the container's top-level window. IShellBrowser allows 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. IShellBrowser 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 Windows Explorer and by the Windows File Open common dialog box.
When to Use
When implementing a namespace extension, notably the IShellView interface, you will use the IShellBrowser implementation that is passed to IShellView::CreateViewWindow to communicate with Windows Explorer.
IShellBrowser is derived from IOleWindow. The following are the methods specific to IShellBrowser.
IShellBrowser Methods Description BrowseObject Tells Windows Explorer to browse in another folder. EnableModelessSB Enables or disables modeless windows of Windows Explorer, such as a floating toolbar. GetControlWindow Gets the window handle to a Windows Explorer control. GetViewStateStream Returns a view-specific stream that can be used to read and write the persistent data for a view. InsertMenusSB Inserts Windows Explorer's menu items to an empty menu created by the view. OnViewWindowActive Informs Windows Explorer that the view was activated. QueryActiveShellView Returns the currently activated (displayed) shell view object. RemoveMenusSB Instructs the container to remove its items from a composite menu. The tasks it performs are the opposite of InsertMenusSB tasks. SendControlMsg Sends messages to Windows Explorer controls. SetMenuSB Installs the composite menu in Windows Explorer. SetStatusTextSB Sets and displays status text in the Windows Explorer window. SetToolbarItems Adds toolbar items to Windows Explorer's toolbar. TranslateAcceleratorSB Reserved for future use.
Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.