SetDlgItemInt, fonction (winuser.h)

Article
08/28/2023

Définit le texte d’un contrôle dans une boîte de dialogue sur la représentation sous forme de chaîne d’une valeur entière spécifiée.

Syntaxe

BOOL SetDlgItemInt(
  [in] HWND hDlg,
  [in] int  nIDDlgItem,
  [in] UINT uValue,
  [in] BOOL bSigned
);

Paramètres

[in] hDlg

Type : HWND

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

[in] nIDDlgItem

Type : int

Contrôle à modifier.

[in] uValue

Type : UINT

Valeur entière utilisée pour générer le texte de l’élément.

[in] bSigned

Type : BOOL

Indique si le paramètre uValue est signé ou non signé. Si ce paramètre a la valeur TRUE, uValue est signé. Si ce paramètre a la valeur TRUE et que uValue est inférieur à zéro, un signe moins est placé avant le premier chiffre de la chaîne. Si ce paramètre a la valeur FALSE, uValue n’est pas signé.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Pour définir le nouveau texte, cette fonction envoie un message WM_SETTEXT au contrôle spécifié.

Spécifications


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-2 (introduit dans Windows 10, version 10.0.10240)