GetDlgItemInt, fonction (winuser.h)

Article
09/29/2022

Convertit le texte d’un contrôle spécifié dans une boîte de dialogue en valeur entière.

Syntaxe

UINT GetDlgItemInt(
  [in]            HWND hDlg,
  [in]            int  nIDDlgItem,
  [out, optional] BOOL *lpTranslated,
  [in]            BOOL bSigned
);

Paramètres

[in] hDlg

Type : HWND

Handle de la boîte de dialogue qui contient le contrôle d’intérêt.

[in] nIDDlgItem

Type : int

Identificateur du contrôle dont le texte doit être traduit.

[out, optional] lpTranslated

Type : BOOL*

Indique la réussite ou l’échec (TRUE indique la réussite, FALSE indique l’échec).

Si ce paramètre a la valeur NULL, la fonction ne retourne aucune information sur la réussite ou l’échec.

[in] bSigned

Type : BOOL

Indique si la fonction doit examiner le texte d’un signe moins au début et retourner une valeur entière signée si elle en trouve une (TRUE spécifie qu’elle doit être effectuée, FALSE qu’elle ne doit pas).

Valeur retournée

Type : UINT

Si la fonction réussit, la variable pointée par lpTranslated a la valeur TRUE et la valeur de retour est la valeur traduite du texte du contrôle.

Si la fonction échoue, la variable pointée par lpTranslated a la valeur FALSE et la valeur de retour est égale à zéro. Notez que, étant donné que zéro est une valeur traduite possible, une valeur de retour de zéro n’indique pas par elle-même l’échec.

Si lpTranslated a la valeur NULL, la fonction ne retourne aucune information sur la réussite ou l’échec.

Notez que, si le paramètre bSigned a la valeur TRUE et qu’il existe un signe moins (–) au début du texte, GetDlgItemInt convertit le texte en valeur entière signée. Sinon, la fonction crée une valeur entière non signée. Pour obtenir la valeur appropriée dans ce cas, convertissez la valeur de retour en un type int .

Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction GetDlgItemInt récupère le texte du contrôle spécifié en envoyant au contrôle un message WM_GETTEXT . La fonction traduit le texte récupéré en déshabillant tous les espaces supplémentaires au début du texte, puis en convertissant les chiffres décimaux. La fonction cesse de traduire lorsqu’elle atteint la fin du texte ou rencontre un caractère non numérique.

La fonction GetDlgItemInt retourne zéro si la valeur traduite est supérieure à INT_MAX (pour les nombres signés) ou UINT_MAX (pour les nombres non signés).

Exemples

Pour obtenir un exemple, voir Création d’une boîte de dialogue sans mode.

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 (include Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-dialogbox-l1-1-2 (introduit dans Windows 10, version 10.0.10240)