Interface IShellWindows (exdisp.h)

Artigo
08/23/2023

Fornece acesso à coleção de janelas abertas do Shell.

Herança

A interface IShellWindows herda da interface IDispatch . O IShellWindows também tem estes tipos de membros:

Métodos

A interface IShellWindows tem esses métodos.


IShellWindows::_NewEnum Recupera um enumerador para a coleção de janelas do Shell.
IShellWindows::FindWindowSW Localiza uma janela na coleção de janelas do Shell e retorna o identificador da janela e a interface IDispatch.
IShellWindows::get_Count Obtém o número de janelas na coleção de janelas do Shell.
IShellWindows::Item Retorna a janela do Shell registrada para um índice especificado.
IShellWindows::OnActivated Ocorre quando o estado de ativação de uma janela do Shell é alterado.
IShellWindows::OnCreated Ocorre quando uma nova janela shell é criada para um quadro.
IShellWindows::OnNavigate Ocorre quando uma janela do Shell é navegada para um novo local.
IShellWindows::P rocessAttachDetach Preterido. Sempre retorna S_OK.
IShellWindows::Register Registra uma janela aberta como uma janela do Shell; a janela é especificada pelo identificador.
IShellWindows::RegisterPending Registra uma janela pendente como uma janela do Shell; a janela é especificada por um PIDL absoluto.
IShellWindows::Revoke Revoga o registro de uma janela do Shell e remove a janela da coleção de janelas do Shell.

Comentários

Uma janela do Shell é uma janela que foi registrada chamando IShellWindows::Register ou IShellWindows::RegisterPending. Após o registro, a janela especificada é adicionada à coleção de janelas do Shell e recebe um cookie que identifica exclusivamente a janela dentro da coleção. Uma janela pode ser não registrada chamando IShellWindows::Revoke.

A coleção De janelas do Shell inclui janelas do explorador de arquivos e janelas do navegador da Web internet Explorer e navegadores da Web de terceiros). Normalmente, cada janela do Shell implementa IDispatch; IShellWindows::Item e IShellWindows::FindWindowSW fornecem maneiras de acessar a interface IDispatch de uma janela do Shell. Para obter mais informações, consulte Interface dispatch e funções de automação.

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

O exemplo a seguir mostra como recuperar uma instância do 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();
    }
}