WM_SETTEXT (Compact 2013)

3/28/2014

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

See Also

Reference

Window Messages
DefWindowProc
CB_SELECTSTRING
WM_GETTEXT