FindWindowExA, fonction (winuser.h)
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 sensible à 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 vers la fenêtre parente dont les fenêtres enfants doivent être recherchées.
Si hwndParent est NULL, la fonction utilise la fenêtre de bureau comme fenêtre parente. La fonction recherche entre 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 est NULL, la recherche commence par la première fenêtre enfant de hwndParent.
Notez que si les deux hwndParent et hwndChildAfter sont 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
Si lpszClass est une chaîne, elle spécifie le nom de la classe de fenêtre. Le nom de classe peut être n’importe quel nom inscrit auprès de RegisterClass ou RegisterClassEx, ou tout nom de classe de contrôle prédéfini, 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 est NULL, tous les noms de fenêtre correspondent.
Valeur de retour
Type : HWND
Si la fonction réussit, la valeur de retour est un handle vers la fenêtre qui a les noms de classe et de fenêtre spécifiés.
Si la fonction échoue, la valeur de retour est NULL . Pour obtenir des informations d’erreur étendues, 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 façon 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éé.
Note
L’en-tête winuser.h définit FindWindowEx comme 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | winuser.h (include 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) |
Voir aussi
conceptuelle
de référence