Share via

IExplorerBrowserEvents-Schnittstelle (shobjidl_core.h)

  • Artikel

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)

Weitere Informationen

IExplorerBrowser