Partager via


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

CréerWindow

CreateWindowEx

Boîtes de dialogue

GetDlgItem

Référence