windows_programming_notes.nbk: Home | Index | Next Page: SetDlgItemText | Previous Page: SetDCPenColor

 SetDlgItemInt

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

Syntax

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

Parameters

• hDlg
  [in] Handle to the dialog box that contains the control.
• nIDDlgItem
  [in] Specifies the control to be changed.
• uValue
  [in] Specifies the integer value used to generate the item text.
• bSigned
  [in] 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 Value

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.

Function Information

• Minimum DLL Version user32.dll
• Header Declared in Winuser.h, include Windows.h
• Import library User32.lib
• Minimum operating systems Windows 95, Windows NT 3.1
• Unicode Implemented as Unicode version.

windows_programming_notes.nbk: Home | Index | Next Page: SetDlgItemText | Previous Page: SetDCPenColor

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time