Fonction FindWindowExA (winuser.h)

Article
08/27/2023

Récupère un handle dans une fenêtre dont le nom de classe et le nom de la fenêtre correspondent aux chaînes spécifiées. La fonction recherche les fenêtres enfants, en commençant par celle qui suit la fenêtre enfant spécifiée. Cette fonction n’effectue pas de recherche respectant la casse.

Syntaxe

HWND FindWindowExA(
  [in, optional] HWND   hWndParent,
  [in, optional] HWND   hWndChildAfter,
  [in, optional] LPCSTR lpszClass,
  [in, optional] LPCSTR lpszWindow
);

Paramètres

[in, optional] hWndParent

Type : HWND

Handle de la fenêtre parente dont les fenêtres enfants doivent faire l’objet d’une recherche.

Si hwndParent a la valeur NULL, la fonction utilise la fenêtre de bureau comme fenêtre parente. La fonction effectue des recherches parmi les fenêtres qui sont des fenêtres enfants du bureau.

Si hwndParent est HWND_MESSAGE, la fonction recherche toutes les fenêtres de message uniquement.

[in, optional] hWndChildAfter

Type : HWND

Handle vers une fenêtre enfant. La recherche commence par la fenêtre enfant suivante dans l’ordre Z. La fenêtre enfant doit être une fenêtre enfant directe de hwndParent, pas seulement une fenêtre descendante.

Si hwndChildAfter a la valeur NULL, la recherche commence par la première fenêtre enfant de hwndParent.

Notez que si hwndParent et hwndChildAfter sont tous deux NULL, la fonction recherche toutes les fenêtres de niveau supérieur et de message uniquement.

[in, optional] lpszClass

Type : LPCSTR

Nom de classe ou atome de classe créé par un appel précédent à la fonction RegisterClass ou RegisterClassEx . L’atome doit être placé dans le mot d’ordre inférieur de lpszClass ; le mot d’ordre élevé doit être égal à zéro.

Si lpszClass est une chaîne, il spécifie le nom de la classe window. Le nom de classe peut être n’importe quel nom inscrit auprès de RegisterClass ou RegisterClassEx, ou d’un des noms prédéfinis de classe de contrôle, ou il peut être MAKEINTATOM(0x8000). Dans ce dernier cas, 0x8000 est l’atome d’une classe de menu. Pour plus d’informations, consultez la section Remarques de cette rubrique.

[in, optional] lpszWindow

Type : LPCSTR

Nom de la fenêtre (titre de la fenêtre). Si ce paramètre a la valeur NULL, tous les noms de fenêtre correspondent.

Valeur retournée

Type : HWND

Si la fonction réussit, la valeur de retour est un handle de la fenêtre qui a les noms de la classe et de la fenêtre spécifiés.

Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction FindWindowEx recherche uniquement les fenêtres enfants directes. Il ne recherche pas d’autres descendants.

Si le paramètre lpszWindow n’est pas NULL, FindWindowEx appelle la fonction GetWindowText pour récupérer le nom de la fenêtre à des fins de comparaison. Pour obtenir une description d’un problème potentiel qui peut survenir, consultez la section Remarques de GetWindowText.

Une application peut appeler cette fonction de la manière suivante.

FindWindowEx( NULL, NULL, MAKEINTATOM(0x8000), NULL );

Notez que 0x8000 est l’atome d’une classe de menu. Lorsqu’une application appelle cette fonction, la fonction vérifie si un menu contextuel est affiché que l’application a créé.

Notes

L’en-tête winuser.h définit FindWindowEx comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-window-l1-1-1 (introduit dans Windows 8.1)