FindWindowA, fonction (winuser.h)

Article
11/20/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 sensible à la casse.

Pour rechercher des fenêtres enfants, à partir d’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 de bas ordre de lpClassName; le mot de haut ordre 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 l’un des noms de classe de contrôle prédéfinis.

Si lpClassName est NULL, il recherche n’importe quelle 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 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 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 pour la comparaison. Pour obtenir une description d’un problème potentiel qui peut survenir, consultez les remarques pour GetWindowText.

Exemples

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

Note

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