Interfaccia IShellWindows (exdisp.h)

Articolo
02/28/2024

Fornisce l'accesso alla raccolta di finestre della shell aperte.

Ereditarietà

L'interfaccia IShellWindows eredita dall'interfaccia IDispatch . IShellWindows include anche questi tipi di membri:

Metodi

L'interfaccia IShellWindows include questi metodi.


IShellWindows::_NewEnum Recupera un enumeratore per la raccolta di finestre shell.
IShellWindows::FindWindowSW Trova una finestra nell'insieme Delle finestre della shell e restituisce l'handle della finestra e l'interfaccia IDispatch.
IShellWindows::get_Count Ottiene il numero di finestre nell'insieme Shell Windows.
IShellWindows::Item Restituisce la finestra shell registrata per un indice specificato.
IShellWindows::OnActivated Si verifica quando lo stato di attivazione di una finestra della shell cambia.
IShellWindows::OnCreated Si verifica quando viene creata una nuova finestra shell per un frame.
IShellWindows::OnNavigate Si verifica quando una finestra della shell viene spostata in una nuova posizione.
IShellWindows::P rocessAttachDetach Deprecato. Restituisce sempre S_OK.
IShellWindows::Register Registra una finestra aperta come finestra shell; la finestra viene specificata dall'handle.
IShellWindows::RegisterPending Registra una finestra in sospeso come finestra shell; la finestra viene specificata da un PIDL assoluto.
IShellWindows::Revoke Revoca la registrazione di una finestra della shell e rimuove la finestra dall'insieme Shell Windows.

Commenti

Una finestra shell è una finestra registrata chiamando IShellWindows::Register o IShellWindows::RegisterPending. Al momento della registrazione, la finestra specificata viene aggiunta alla raccolta di finestre shell e ha concesso un cookie che identifica in modo univoco la finestra all'interno della raccolta. Una finestra può essere annullata chiamando IShellWindows::Revoke.

La raccolta di finestre shell include finestre di Esplora file e Browser Web Windows Internet Explorer e Web browser di terze parti. In genere ogni finestra shell implementa IDispatch; IShellWindows::Item e IShellWindows::FindWindowSW consentono di accedere all'interfaccia IDispatch di una finestra della shell. Per altre informazioni, vedere Interfaccia dispatch e funzioni di automazione.

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

Nell'esempio seguente viene illustrato come recuperare un'istanza di 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();
    }
}