GetDlgCtrlID, fonction (winuser.h)

Article
08/27/2023

Récupère l’identificateur du contrôle spécifié.

Syntaxe

int GetDlgCtrlID(
  [in] HWND hWnd
);

Paramètres

[in] hWnd

Type : HWND

Handle du contrôle.

Valeur retournée

Type : int

Si la fonction réussit, la valeur de retour est l’identificateur du contrôle.

Si la fonction échoue, la valeur de retour est égale à zéro. Une valeur non valide pour le paramètre hwndCtl , par exemple, entraîne l’échec de la fonction. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

GetDlgCtrlID accepte les poignées de fenêtre enfants ainsi que les poignées de contrôles dans les boîtes de dialogue. Une application définit l’identificateur d’une fenêtre enfant lorsqu’elle crée la fenêtre en affectant la valeur d’identificateur au paramètre hmenu lors de l’appel de la fonction CreateWindow ou CreateWindowEx .

Bien que GetDlgCtrlID puisse retourner une valeur si hwndCtl est un handle vers une fenêtre de niveau supérieur, les fenêtres de niveau supérieur ne peuvent pas avoir d’identificateurs et une telle valeur de retour n’est jamais valide.

Exemples

Pour obtenir un exemple, consultez Initialisation d’une boîte de dialogue.

Configuration requise


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-dialogbox-l1-1-0 (introduit dans Windows 8)