Méthode IShellBrowser ::GetControlWindow (shobjidl_core.h)

Article
03/04/2024

Obtient le handle de fenêtre dans un contrôle de navigateur.

Syntaxe

HRESULT GetControlWindow(
  UINT id,
  HWND *phwnd
);

Paramètres

id

Type : UINT

Handle de contrôle demandé. Ce paramètre peut être l’une des valeurs suivantes :

FCW_TOOLBAR

Récupère le handle de fenêtre dans la barre d’outils du navigateur.

FCW_STATUS

Récupère le handle de fenêtre dans la barre de status du navigateur.

FCW_TREE

Récupère le handle de fenêtre dans l’arborescence du navigateur.

FCW_PROGRESS

Récupère le handle de fenêtre dans la barre de progression du navigateur.

phwnd

Type : HWND*

Adresse du handle de fenêtre au contrôle Windows Explorer.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur définie par COM dans le cas contraire.

Remarques

GetControlWindow est utilisé pour permettre aux vues de manipuler directement les contrôles du navigateur. FCW_TREE doit être utilisé uniquement pour déterminer si l’arborescence est présente.

Remarques relatives à l’appel d’applications

GetControlWindow est utilisé pour manipuler et tester l’état des fenêtres de contrôle. N’envoyez pas de messages directement à ces contrôles ; utilisez plutôt IShellBrowser ::SendControlMsg. Préparez-vous à ce que cette méthode retourne NULL. Les versions ultérieures de Windows Explorer peuvent ne pas inclure de barre d’outils, de barre d’status ou d’arborescence.

Remarques aux implémenteurs

GetControlWindow retourne le handle de fenêtre à ces contrôles s’ils existent dans votre implémentation.

Voir aussi IShellBrowser

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)
DLL	Shell32.dll (version 4.0 ou ultérieure)

Partager via