IShellWindows

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

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

Shell ウィンドウのコレクションには、ファイル エクスプローラーのウィンドウと Web ブラウザーのウィンドウ(Internet Explorer およびサードパーティ製の Web ブラウザー)が含まれます。通常、各 Shell ウィンドウは IDispatch を実装しています。IShellWindows::Item および IShellWindows::FindWindowSW は、Shell ウィンドウの IDispatch インターフェイスにアクセスする手段を提供します。詳細については、Dispatch Interface and Automation Functions を参照してください。

次の例は、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();
    }
}

Shell ウィンドウのコレクション内のウィンドウ数を取得します。

型: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。

指定したインデックスに対応する、登録済みの Shell ウィンドウを返します。

型: HRESULT

次のいずれかの値、または標準の結果コード。

Shell ウィンドウのコレクションに対する列挙子を取得します。

型: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。

開いているウィンドウを Shell ウィンドウとして登録します。ウィンドウはハンドルで指定します。

型: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。

Shell ウィンドウのコレクションにおける cookie とは、登録済みの Shell ウィンドウを一意に識別するトークンです。

このメソッドは開いているウィンドウを登録するために使用します。ウィンドウが開くのを待機中(pending)の場合は、代わりに IShellWindows::RegisterPending を使用してください。

待機中のウィンドウを Shell ウィンドウとして登録します。ウィンドウは絶対 PIDL で指定します。

型: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。

Shell ウィンドウのコレクションにおける cookie とは、登録済みの Shell ウィンドウを一意に識別するトークンです。

このメソッドは開くのを待機中のウィンドウを登録するために使用します。ウィンドウが既に開いている場合は、代わりに IShellWindows::Register を使用してください。ウィンドウの登録解除には IShellWindows::Revoke を使用します。

Shell ウィンドウの登録を取り消し、そのウィンドウを Shell ウィンドウのコレクションから削除します。

型: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。

Shell ウィンドウのコレクションにおける cookie とは、登録済みの Shell ウィンドウを一意に識別するトークンです。

開いているウィンドウをハンドルで登録するには IShellWindows::Register メソッドを使用します。開くのを待機中のウィンドウを絶対 PIDL で登録するには IShellWindows::RegisterPending メソッドを使用します。

Shell ウィンドウが新しい場所へナビゲートされたときに発生します。

型: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。

ウィンドウは Shell ウィンドウとして登録されると cookie が付与されます。詳細については、IShellWindows::Register を参照してください。

Shell ウィンドウのアクティブ化状態が変化したときに発生します。

型: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。

ウィンドウは Shell ウィンドウとして登録されると cookie が付与されます。詳細については、IShellWindows::Register を参照してください。

Shell ウィンドウのコレクション内でウィンドウを検索し、そのウィンドウのハンドルと IDispatch インターフェイスを返します。

型: HRESULT

次のいずれかの値、または標準の結果コード。

SWFO_COOKIEPASSED フラグが設定されている場合、pvarLoc は PIDL ではなく cookie として解釈されます。

フレーム用に新しい Shell ウィンドウが作成されたときに発生します。

型: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。

ウィンドウは Shell ウィンドウとして登録されると cookie が付与されます。詳細については、IShellWindows::Register を参照してください。

非推奨です。常に S_OK を返します。

型: HRESULT

常に S_OK を返します。