IShellWindows インターフェイス (exdisp.h)

[アーティクル]
02/28/2024

開いているシェルウィンドウのコレクションへのアクセスを提供します。

継承

IShellWindows インターフェイスは、IDispatch インターフェイスから継承されます。 IShellWindows には、次の種類のメンバーもあります。

メソッド

IShellWindows インターフェイスには、次のメソッドがあります。


IShellWindows::_NewEnum シェルウィンドウのコレクションの列挙子を取得します。
IShellWindows::FindWindowSW シェルウィンドウコレクション内のウィンドウを検索し、ウィンドウのハンドルと IDispatch インターフェイスを返します。
IShellWindows::get_Count シェルウィンドウコレクション内のウィンドウの数を取得します。
IShellWindows::Item 指定したインデックスの登録済みシェルウィンドウを返します。
IShellWindows::OnActivated シェルウィンドウのアクティブ化状態が変更されたときに発生します。
IShellWindows::OnCreated フレームに対して新しいシェルウィンドウが作成されたときに発生します。
IShellWindows::OnNavigate シェルウィンドウが新しい場所に移動したときに発生します。
IShellWindows::P rocessAttachDetach 非推奨になりました。常に S_OK を返します。
IShellWindows::Register 開いているウィンドウをシェルウィンドウとして登録します。ウィンドウはハンドルで指定されます。
IShellWindows::RegisterPending 保留中のウィンドウをシェルウィンドウとして登録します。ウィンドウは絶対 PIDL で指定されます。
IShellWindows::Revoke シェルウィンドウの登録を取り消し、Shell ウィンドウコレクションからウィンドウを削除します。

注釈

シェルウィンドウは、IShellWindows::Register または IShellWindows::RegisterPending を呼び出して登録されたウィンドウです。登録時に、指定されたウィンドウがシェルウィンドウのコレクションに追加され、コレクション内のウィンドウを一意に識別する Cookie が付与されます。ウィンドウを登録解除するには、 IShellWindows::Revoke を呼び出します。

シェルウィンドウコレクションには、エクスプローラーウィンドウと Web ブラウザーウィンドウインターネットエクスプローラーおよびサードパーティの Web ブラウザー) が含まれます。通常、各シェルウィンドウは IDispatch を実装します。 IShellWindows::Item と IShellWindows::FindWindowSW は、シェルウィンドウの IDispatch インターフェイスにアクセスする方法を提供します。詳細については、「ディスパッチインターフェイスとオートメーション関数」を参照してください。

IID	IID_IShellWindows (85CB6900-4D95-11CF-960C-0080C7F4EE85)
CLSID	CLSID_ShellWindows (9BA05972-F6A8-11CF-A442-00A0C90A8F39)

次の例は、 IShellWindows インスタンスを取得する方法を示しています。

#include "exdisp.h"
                
...

IShellWindows *psw;
HRESULT hr;

hr = CoInitialize(NULL);
if (SUCCEEDED(hr))
{
    hr = CoCreateInstance(
        CLSID_ShellWindows,
        NULL,
        CLSCTX_ALL,
        IID_IShellWindows,
        (void**)&psw
    );
    
    if (SUCCEEDED(hr))
    {
        // Use the IShellWindows instance...
        
        psw->Release();
    }
}