IExplorerBrowserEvents interface
Exposes methods for notification of Explorer browser navigation and view creation events.
Members
The IExplorerBrowserEvents interface inherits from the IUnknown interface. IExplorerBrowserEvents also has these types of members:
Methods
The IExplorerBrowserEvents interface has these methods.
| Method | Description |
|---|---|
| OnNavigationComplete |
Notifies clients that the Explorer browser has successfully navigated to a Shell folder. |
| OnNavigationFailed |
Notifies clients that the Explorer browser has failed to navigate to a Shell folder. |
| OnNavigationPending |
Notifies clients of a pending Explorer browser navigation to a Shell folder. |
| 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
|
Minimum supported client |
Windows Vista [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2008 [desktop apps only] |
|
Header |
|
|
IDL |
|
See also