Interface IShellWindows (exdisp.h)

Article
02/28/2024

Fournit l’accès à la collection de fenêtres Shell ouvertes.

Héritage

L’interface IShellWindows hérite de l’interface IDispatch . IShellWindows possède également les types de membres suivants :

Méthodes

L’interface IShellWindows comporte ces méthodes.


IShellWindows ::_NewEnum Récupère un énumérateur pour la collection de fenêtres Shell.
IShellWindows ::FindWindowSW Recherche une fenêtre dans la collection De fenêtres Shell et retourne le handle et l’interface IDispatch de la fenêtre.
IShellWindows ::get_Count Obtient le nombre de fenêtres dans la collection de fenêtres Shell.
IShellWindows ::Item Retourne la fenêtre Shell inscrite pour un index spécifié.
IShellWindows ::OnActivated Se produit quand l’état d’activation d’une fenêtre Shell change.
IShellWindows ::OnCreated Se produit lorsqu’une nouvelle fenêtre Shell est créée pour un cadre.
IShellWindows ::OnNavigate Se produit lorsqu’une fenêtre Shell est naviguée vers un nouvel emplacement.
IShellWindows ::P rocessAttachDetach Action déconseillée. Retourne toujours S_OK.
IShellWindows ::Register Inscrit une fenêtre ouverte en tant que fenêtre d’interpréteur de commandes ; la fenêtre est spécifiée par handle.
IShellWindows ::RegisterPending Inscrit une fenêtre en attente en tant que fenêtre d’interpréteur de commandes ; la fenêtre est spécifiée par un PIDL absolu.
IShellWindows ::Revoke Révoque l’inscription d’une fenêtre Shell et supprime la fenêtre de la collection de fenêtres Shell.

Remarques

Une fenêtre Shell est une fenêtre qui a été inscrite en appelant IShellWindows ::Register ou IShellWindows ::RegisterPending. Lors de l’inscription, la fenêtre spécifiée est ajoutée à la collection de fenêtres Shell et reçoit un cookie qui identifie de manière unique la fenêtre au sein de la collection. Une fenêtre peut être désinscrit en appelant IShellWindows ::Revoke.

La collection de fenêtres Shell comprend des fenêtres d’explorateur de fichiers et des fenêtres de navigateur web internet Explorer et des navigateurs web tiers). Normalement, chaque fenêtre Shell implémente IDispatch ; IShellWindows ::Item et IShellWindows ::FindWindowSW permettent d’accéder à l’interface IDispatch d’une fenêtre Shell. Pour plus d’informations, consultez Dispatch Interface et Automation Functions.

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

L’exemple suivant montre comment récupérer un instance 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();
    }
}