Интерфейс IExplorerBrowserEvents (shobjidl_core.h)
Предоставляет методы для уведомления о Обозреватель событиях навигации в браузере и создания представлений.
Наследование
Интерфейс IExplorerBrowserEvents наследуется от интерфейса IUnknown . IExplorerBrowserEvents также имеет следующие типы элементов:
Методы
Интерфейс IExplorerBrowserEvents содержит следующие методы.
|
IExplorerBrowserEvents::OnNavigationComplete Уведомляет клиентов о том, что браузер Обозреватель успешно перешел в папку оболочки. |
|
IExplorerBrowserEvents::OnNavigationFailed Уведомляет клиентов о том, что браузеру Обозреватель не удалось перейти к папке оболочки. |
|
IExplorerBrowserEvents::OnNavigationPending Уведомляет клиентов об ожидающей Обозреватель навигации в браузере в папку оболочки. |
|
IExplorerBrowserEvents::OnViewCreated Уведомляет клиентов о том, что представление браузера Обозреватель создано и может быть изменено. |
Комментарии
Реализуйте этот интерфейс, чтобы получать уведомления о событиях создания навигации и просмотра IExplorerBrowser ; При необходимости реализация позволяет обрабатывать эти события.
IExplorerBrowser должен получать уведомления о событиях IExplorerBrowser . Клиенты делают это путем вызова метода IExplorerBrowser::Advise . Это позволяет выполнять обратные вызовы событий IExplorerBrowser клиенту с помощью методов из IExplorerBrowserEvents. Чтобы остановить обратные вызовы событий, клиент должен вызвать метод IExplorerBrowser::Unadvise , иначе может возникнуть утечка памяти.
Во время первой навигации (IExplorerBrowser::BrowseToObject) Обозреватель синхронно вызывает методы в этом интерфейсе. После этого Обозреватель вызывает их асинхронно. Порядок обратных вызовов событий выглядит следующим образом: IExplorerBrowserEvents::OnNavigationPending; IExplorerBrowserEvents::OnViewCreated; и IExplorerBrowserEvents::OnNavigationComplete или IExplorerBrowserEvents::OnNavigationFailed в зависимости от того, была ли навигация успешной или неудачной.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | shobjidl_core.h (включая Shobjidl.h) |