Share via


SetDlgItemText

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Syntax

BOOL SetDlgItemText( 
  HWND hDlg, 
  int nIDDlgItem, 
  LPCTSTR lpString
); 

Parameters

  • hDlg
    [in] Handle to the dialog box that contains the control.
  • nIDDlgItem
    [in] Identifies the control with a title or text that is to be set.
  • lpString
    [in] Long pointer to the null-terminated string that contains the text to be copied to the control.

Return Value

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

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

Requirements

Header winuser.h
Library Dlgmgr.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

GetDlgItemInt
GetDlgItemText
SetDlgItemInt
WM_SETTEXT
Dialog Boxes Functions