IExplorerBrowserEvents インターフェイス (shobjidl_core.h)
ブラウザー ナビゲーションとビュー作成イベントエクスプローラー通知するメソッドを公開します。
継承
IExplorerBrowserEvents インターフェイスは、IUnknown インターフェイスから継承されます。 IExplorerBrowserEvents には、 次の種類のメンバーもあります。
メソッド
IExplorerBrowserEvents インターフェイスには、これらのメソッドがあります。
|
IExplorerBrowserEvents::OnNavigationComplete エクスプローラー ブラウザーがシェル フォルダーに正常に移動したことをクライアントに通知します。 |
|
IExplorerBrowserEvents::OnNavigationFailed エクスプローラー ブラウザーがシェル フォルダーへの移動に失敗したことをクライアントに通知します。 |
|
IExplorerBrowserEvents::OnNavigationPending 保留中のエクスプローラーブラウザー ナビゲーションをシェル フォルダーにクライアントに通知します。 |
|
IExplorerBrowserEvents::OnViewCreated エクスプローラー ブラウザーのビューが作成され、変更できることをクライアントに通知します。 |
注釈
IExplorerBrowser ナビゲーションとビュー作成イベントの通知を受け取るために、このインターフェイスを実装します。実装では、必要に応じて、これらのイベントの処理が可能になります。
IExplorerBrowser イベントの通知を受け取る実装者 (クライアント) に IExplorerBrowser を通知する必要があります。 クライアントは 、IExplorerBrowser::Advise メソッドを呼び出すことによってこれを行います。 これにより、 IExplorerBrowserEvents のメソッドを使用して 、IExplorerBrowser によるクライアントへのイベント コールバックが有効になります。 イベント コールバックを停止するには、クライアントでメソッド IExplorerBrowser::Unadvise を呼び出す必要があります。または、メモリ リークが発生する可能性があります。
最初のナビゲーション (IExplorerBrowser::BrowseToObject) 中に、エクスプローラーはこのインターフェイス内のメソッドを同期的に呼び出します。 その後、エクスプローラーはそれらを非同期的に呼び出します。 イベント コールバックの順序は次のとおりです。 IExplorerBrowserEvents::OnNavigationPending; IExplorerBrowserEvents::OnViewCreated;ナビゲーションが成功したか失敗したかに応じて、 IExplorerBrowserEvents::OnNavigationComplete または IExplorerBrowserEvents::OnNavigationFailed 。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | shobjidl_core.h (Shobjidl.h を含む) |