GetDlgCtrlID, fonction (winuser.h)
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) |
Voir aussi
Conceptuel
Référence