WM_SETTEXT

  • Article

This message is sent by an application to set the window text.

WM_SETTEXT wParam = 0; 
  lParam = (LPARAM)(LPCTSTR) lpsz;

Parameters

  • lpsz
    Long pointer to a null-terminated string that contains the window text.

Return Values

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

OS Versions: Windows CE 1.0 and later.
Header: Winuser.h.

See Also

DefWindowProc | CB_SELECTSTRING | WM_GETTEXT | Windows Messages

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.