GetDlgItem, fonction (winuser.h)

Article
03/13/2024

Récupère un handle dans un contrôle dans la boîte de dialogue spécifiée.

Syntaxe

HWND GetDlgItem(
  [in, optional] HWND hDlg,
  [in]           int  nIDDlgItem
);

Paramètres

[in, optional] hDlg

Type : HWND

Handle de la boîte de dialogue qui contient le contrôle.

[in] nIDDlgItem

Type : int

Identificateur du contrôle à récupérer.

Valeur retournée

Type : HWND

Si la fonction réussit, la valeur de retour est le handle de fenêtre du contrôle spécifié.

Si la fonction échoue, la valeur de retour est NULL, indiquant un handle de boîte de dialogue non valide ou un contrôle inexistant. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Vous pouvez utiliser la fonction GetDlgItem avec n’importe quelle paire de fenêtres parent-enfant, pas seulement avec des boîtes de dialogue. Tant que le paramètre hDlg spécifie une fenêtre parente et que la fenêtre enfant a un identificateur unique (tel que spécifié par le paramètre hMenu dans la fonction CreateWindow ou CreateWindowEx qui a créé la fenêtre enfant), GetDlgItem retourne un handle valide à la fenêtre enfant.

Exemples

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

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