SetDlgItemInt

The SetDlgItemInt function sets the text of a control in a dialog box to the string representation of a specified integer value.

BOOL SetDlgItemInt(
  HWND hDlg,       // handle of dialog box
  int nIDDlgItem,  // identifier of control
  UINT uValue,     // value to set
  BOOL bSigned     // signed or unsigned indicator
);
 

Parameters

hDlg

Identifies the dialog box that contains the control.

nIDDlgItem

Specifies the control to be changed.

uValue

Specifies the integer value used to generate the item text.

bSigned

Specifies whether the uValue parameter is signed or unsigned. If this parameter is TRUE, uValue is signed. If this parameter is TRUE and uValue is less than zero, a minus sign is placed before the first digit in the string. If this parameter is FALSE, uValue is unsigned.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

To set the new text, this function sends a WM_SETTEXT message to the specified control.

Windows CE: The bSigned parameter is not used. All values passed in the nValue parameter are assumed to be signed.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Requires version 1.0 or later.
  Header: Declared in winuser.h.
  Import Library: Use user32.lib.

See Also

Dialog Boxes Overview, Dialog Box Functions, GetDlgItemInt, SetDlgItemText, WM_SETTEXT