IExplorerBrowserEvents interface (shobjidl_core.h)
Exposes methods for notification of Explorer browser navigation and view creation events.
The IExplorerBrowserEvents interface inherits from the IUnknown interface. IExplorerBrowserEvents also has these types of members:
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.|
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.
|Minimum supported client||Windows Vista [desktop apps only]|
|Minimum supported server||Windows Server 2008 [desktop apps only]|
|Header||shobjidl_core.h (include Shobjidl.h)|