IExplorerBrowserEvents-Schnittstelle (shobjidl_core.h)
Macht Methoden zur Benachrichtigung über Explorer Browsernavigations- und Ansichtserstellungsereignisse verfügbar.
Vererbung
Die IExplorerBrowserEvents-Schnittstelle erbt von der IUnknown-Schnittstelle . IExplorerBrowserEvents verfügt auch über folgende Arten von Membern:
Methoden
Die IExplorerBrowserEvents-Schnittstelle verfügt über diese Methoden.
|
IExplorerBrowserEvents::OnNavigationComplete Benachrichtigt Clients, dass der Explorer Browser erfolgreich zu einem Shellordner navigiert hat. |
|
IExplorerBrowserEvents::OnNavigationFailed Benachrichtigt Clients, dass der Explorer-Browser nicht zu einem Shellordner navigieren konnte. |
|
IExplorerBrowserEvents::OnNavigationPending Benachrichtigt Clients über eine ausstehende Explorer Browsernavigation in einem Shellordner. |
|
IExplorerBrowserEvents::OnViewCreated Benachrichtigt Clients, dass die Ansicht des Explorer Browsers erstellt wurde und geändert werden kann. |
Hinweise
Implementieren Sie diese Schnittstelle, um über IExplorerBrowser-Navigations - und Anzeigeerstellungsereignisse benachrichtigt zu werden; die Implementierung ermöglicht bei Bedarf die Behandlung dieser Ereignisse.
IExplorerBrowser muss über Implementierer (Clients) benachrichtigt werden, die über IExplorerBrowser-Ereignisse informiert werden möchten. Clients tun dies, indem sie die IExplorerBrowser::Advise-Methode aufrufen. Dadurch werden Ereignisrückrufe von IExplorerBrowser mithilfe der Methoden in IExplorerBrowserEvents an den Client aktiviert. Um Ereignisrückrufe zu beenden, muss der Client die Methode IExplorerBrowser::Unadvise aufrufen, da es zu einem Speicherverlust kommen kann.
Während der ersten Navigation (IExplorerBrowser::BrowseToObject) ruft Explorer die Methoden in dieser Schnittstelle synchron auf. Danach ruft Explorer sie asynchron auf. Die Reihenfolge der Ereignisrückrufe lautet wie folgt: IExplorerBrowserEvents::OnNavigationPending; IExplorerBrowserEvents::OnViewCreated; und IExplorerBrowserEvents::OnNavigationComplete oder IExplorerBrowserEvents::OnNavigationFailed , je nachdem, ob die Navigation erfolgreich war oder fehlgeschlagen ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shobjidl_core.h (einschließlich Shobjidl.h) |