Edit

IExplorerBrowserEvents interface (shobjidl_core.h)

  • Article

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)

See also

IExplorerBrowser