IExplorerBrowserEvents 接口 (shobjidl_core.h)
公开资源管理器浏览器导航和视图创建事件的通知方法。
继承
IExplorerBrowserEvents 接口继承自 IUnknown 接口。 IExplorerBrowserEvents 也具有以下类型的成员:
方法
IExplorerBrowserEvents 接口具有这些方法。
IExplorerBrowserEvents::OnNavigationComplete 通知客户端资源管理器浏览器已成功导航到 Shell 文件夹。 |
IExplorerBrowserEvents::OnNavigationFailed 通知客户端资源管理器浏览器无法导航到 Shell 文件夹。 |
IExplorerBrowserEvents::OnNavigationPending 通知客户端挂起的资源管理器浏览器导航到 Shell 文件夹。 |
IExplorerBrowserEvents::OnViewCreated 通知客户端资源管理器浏览器的视图已创建且可以修改。 |
注解
实现此接口以接收 IExplorerBrowser 导航和查看创建事件的通知;如果需要,实现允许处理这些事件。
必须通知 IExplorerBrowser 实现者 (客户端) 谁希望收到 IExplorerBrowser 事件的通知。 客户端通过调用 IExplorerBrowser::Advise 方法执行此操作。 这样就可以使用 IExplorerBrowserEvents 中的方法将 IExplorerBrowser 的事件回调到客户端。 若要停止事件回调,客户端必须调用方法 IExplorerBrowser::Unadvise ,否则可能会导致内存泄漏。
在其第一次导航 (IExplorerBrowser::BrowseToObject) 期间,Explorer 会同步调用此接口中的方法。 之后,资源管理器以异步方式调用它们。 事件回调的顺序如下: IExplorerBrowserEvents::OnNavigationPending; IExplorerBrowserEvents::OnViewCreated;和 IExplorerBrowserEvents::OnNavigationComplete 或 IExplorerBrowserEvents::OnNavigationFailed ,具体取决于导航是成功还是失败。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | shobjidl_core.h (包括 Shobjidl.h) |