Partager via


GetDlgItem, fonction (winuser.h)

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)

Voir aussi

Conceptuel

CreateWindow

CreateWindowEx

Boîtes de dialogue

GetDlgItemInt

GetDlgItemText

Référence