Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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) |