windows_programming_notes.nbk: Home | Index | Next Page: SetEnvironmentVariable | Previous Page: SetDlgItemInt

 SetDlgItemText

The SetDlgItemText function sets the title or text of a control in a dialog box.

BOOL SetDlgItemText(
  HWND hDlg,         // handle to dialog box
  int nIDDlgItem,    // control identifier
  LPCTSTR lpString   // text to set
);

Parameters

hDlg [in] Handle to the dialog box that contains the control. nIDDlgItem [in] Specifies the control with a title or text to be set. lpString [in] Pointer to the null-terminated string that contains the text to be copied to the control.

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

The SetDlgItemText function sends a WM_SETTEXT message to the specified control.

For an example, see Creating a Simple List Box.

windows_programming_notes.nbk: Home | Index | Next Page: SetEnvironmentVariable | Previous Page: SetDlgItemInt

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