|
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.
|
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
