IShellWindows interface (exdisp.h)
Provides access to the collection of open Shell windows.
Inheritance
The IShellWindows interface inherits from the IDispatch interface. IShellWindows also has these types of members:
Methods
The IShellWindows interface has these methods.
| IShellWindows::_NewEnum Retrieves an enumerator for the collection of Shell windows. |
| IShellWindows::FindWindowSW Finds a window in the Shell windows collection and returns the window's handle and IDispatch interface. |
| IShellWindows::get_Count Gets the number of windows in the Shell windows collection. |
| IShellWindows::Item Returns the registered Shell window for a specified index. |
| IShellWindows::OnActivated Occurs when a Shell window's activation state changes. |
| IShellWindows::OnCreated Occurs when a new Shell window is created for a frame. |
| IShellWindows::OnNavigate Occurs when a Shell window is navigated to a new location. |
| IShellWindows::ProcessAttachDetach Deprecated. Always returns S_OK. |
| IShellWindows::Register Registers an open window as a Shell window; the window is specified by handle. |
| IShellWindows::RegisterPending Registers a pending window as a Shell window; the window is specified by an absolute PIDL. |
| IShellWindows::Revoke Revokes a Shell window's registration and removes the window from the Shell windows collection. |
Remarks
A Shell window is a window that has been registered by calling IShellWindows::Register or IShellWindows::RegisterPending. Upon registration, the specified window is added to the collection of Shell windows, and granted a cookie that uniquely identifies the window within the collection. A window can be un-registered by calling IShellWindows::Revoke.
The Shell windows collection includes file explorer windows and web browser windows Internet Explorer and 3rd-party web browsers). Normally each Shell window implements IDispatch; IShellWindows::Item and IShellWindows::FindWindowSW provide ways to access a Shell window's IDispatch interface. For more information, see Dispatch Interface and Automation Functions.
| IID | IID_IShellWindows (85CB6900-4D95-11CF-960C-0080C7F4EE85) |
|---|---|
| CLSID | CLSID_ShellWindows (9BA05972-F6A8-11CF-A442-00A0C90A8F39) |
The following example shows how to retrieve an IShellWindows instance.
#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();
}
}
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | exdisp.h |