FindWindowA, fonction (winuser.h)

Article
05/30/2024

Récupère un handle dans la fenêtre de niveau supérieur dont le nom de classe et le nom de la fenêtre correspondent aux chaînes spécifiées. Cette fonction ne recherche pas les fenêtres enfants. Cette fonction n’effectue pas de recherche respectant la casse.

Pour rechercher des fenêtres enfants, en commençant par une fenêtre enfant spécifiée, utilisez la fonction FindWindowEx .

Syntaxe

HWND FindWindowA(
  [in, optional] LPCSTR lpClassName,
  [in, optional] LPCSTR lpWindowName
);

Paramètres

[in, optional] lpClassName

Type : LPCTSTR

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

Si lpClassName pointe vers une chaîne, il 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 n’importe quel nom de classe de contrôle prédéfini.

Si lpClassName a la valeur NULL, il recherche toute fenêtre dont le titre correspond au paramètre lpWindowName .

[in, optional] lpWindowName

Type : LPCTSTR

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 le nom de classe et le nom de la fenêtre spécifiés.

Si la fonction échoue, la valeur de retour est NULL. Cette fonction ne modifie pas la dernière valeur d’erreur.

Remarques

Si le paramètre lpWindowName n’est pas NULL, FindWindow 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 remarques pour GetWindowText.

Exemples

Pour obtenir un exemple, consultez Récupération du nombre de lignes de défilement de roulette de souris.

Notes

L’en-tête winuser.h définit FindWindow 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-0 (introduit dans Windows 8)