IShellBrowser interface
Implemented by hosts of Shell views (objects that implement IShellView). Exposes methods that provide services for the view it is hosting and other objects that run in the context of the Explorer window.
Members
The IShellBrowser interface inherits from IOleWindow. IShellBrowser also has these types of members:
Methods
The IShellBrowser interface has these methods.
| Method | Description |
|---|---|
| BrowseObject |
Informs Windows Explorer to browse to another folder. |
| EnableModelessSB |
Tells Windows Explorer to enable or disable its modeless dialog boxes. |
| GetControlWindow |
Gets the window handle to a browser control. |
| GetViewStateStream |
Gets an IStream interface that can be used for storage of view-specific state information. |
| InsertMenusSB |
Allows the container to insert its menu groups into the composite menu that is displayed when an extended namespace is being viewed or used. |
| OnViewWindowActive |
Called by the Shell view when the view window or one of its child windows gets the focus or becomes active. |
| QueryActiveShellView |
Retrieves the currently active (displayed) Shell view object. |
| RemoveMenusSB |
Permits the container to remove any of its menu elements from the in-place composite menu and to free all associated resources. |
| SendControlMsg |
Sends control messages to either the toolbar or the status bar in a Windows Explorer window. |
| SetMenuSB |
Installs the composite menu in the view window. |
| SetStatusTextSB |
Sets and displays status text about the in-place object in the container's frame-window status bar. |
| SetToolbarItems |
Adds toolbar items to Windows Explorer's toolbar. |
| TranslateAcceleratorSB |
Translates accelerator keystrokes intended for the browser's frame while the view is active. |
Remarks
Windows Explorer and the Open File common dialog box are examples of implementations of this interface. It is a companion to the IShellView interface exposed by extensions.
Objects that have access to the site chain of the browser can get a reference to the browser on IShellBrowser using IServiceProvider::QueryService, with Service IDs such as SID_STopLevelBrowser and SID_SCommDlgBrowser. See the Knowledge Base article Retrieve the Top-Level IWebBrowser2 Interface from an ActiveX Control for more information on using service IDs.
Windows 7 and later. Windows Explorer context menus can support in-place navigation by using IServiceProvider::QueryService with the Service ID SID_SlnPlaceBrowser.
Requirements
|
Minimum supported client |
Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows 2000 Server [desktop apps only] |
|
Header |
|
|
IDL |
|
|
DLL |
|
See also