WM_SETTEXT
A version of this page is also available for
4/8/2010
This message is sent by an application to set the window text.
Syntax
WM_SETTEXT wParam = 0;
lParam = (LPARAM)(LPCTSTR) lpsz;
Parameters
- lpsz
Long pointer to a null-terminated string that contains the window text.
Return Value
The return value is TRUE if the text is set. It is FALSE (for an edit control), LB_ERRSPACE (for a list box), or CB_ERRSPACE (for a combo box) if insufficient space is available to set the text in the edit control. It is CB_ERR if this message is sent to a combo box without an edit control.
- Default Action
The DefWindowProc function sets and displays the window text.
Remarks
For an edit control, the text is the contents of the edit control. For a combo box, the text is the contents of the edit-control portion of the combo box. For a button, the text is the button name. For other windows, the text is the window title.
This message does not change the current selection in the list box of a combo box. An application should use the CB_SELECTSTRING message to select the item in a list box that matches the text in the edit control.
The DefWindowProc function returns zero for this message.
Requirements
| Header | winuser.h |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |