IExplorerBrowserEvents interface (shobjidl_core.h)
Exposes methods for notification of Explorer browser navigation and view creation events.
Inheritance
The IExplorerBrowserEvents interface inherits from the IUnknown interface. IExplorerBrowserEvents also has these types of members:
Methods
The IExplorerBrowserEvents interface has these methods.
| IExplorerBrowserEvents::OnNavigationComplete Notifies clients that the Explorer browser has successfully navigated to a Shell folder. |
| IExplorerBrowserEvents::OnNavigationFailed Notifies clients that the Explorer browser has failed to navigate to a Shell folder. |
| IExplorerBrowserEvents::OnNavigationPending Notifies clients of a pending Explorer browser navigation to a Shell folder. |
| IExplorerBrowserEvents::OnViewCreated Notifies clients that the view of the Explorer browser has been created and can be modified. |
Remarks
Implement this interface to be notified of IExplorerBrowser navigation and view creation events; implementation enables handling of these events, if desired.
IExplorerBrowser must be notified of implementers (clients) who want to be advised of IExplorerBrowser events. Clients do this by calling the IExplorerBrowser::Advise method. This enables event callbacks by IExplorerBrowser to the client using the methods in IExplorerBrowserEvents. To stop event callbacks, the client must call method IExplorerBrowser::Unadvise or a memory leak may result.
During its first navigation (IExplorerBrowser::BrowseToObject), Explorer calls the methods in this interface synchronously. After that, Explorer calls them asynchronously. The order of the event callbacks is as follows: IExplorerBrowserEvents::OnNavigationPending; IExplorerBrowserEvents::OnViewCreated; and IExplorerBrowserEvents::OnNavigationComplete or IExplorerBrowserEvents::OnNavigationFailed depending on whether the navigation succeeded or failed.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Target Platform | Windows |
| Header | shobjidl_core.h (include Shobjidl.h) |