SetWindowText (Windows CE 5.0)

Send Feedback

This function changes the text of the specified window's title bar, if it has one. If the specified window is a control, the text of the control is changed.

BOOLSetWindowText(   HWNDhWnd,   LPCTSTRlpString );


  • hWnd
    [in] Handle to the window or control whose text is to be changed.
  • lpString
    [in] Long pointer to a null-terminated string to be used as the new title or control text.

Return Values

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


If the target window is owned by the current process, SetWindowText causes a WM_SETTEXT message to be sent to the specified window or control. If the control is a list box control created with the WS_CAPTION style, however, SetWindowText sets the text for the control, not for the list box entries.

The SetWindowText function does not expand tab characters (ASCII code 0x09). Tab characters are displayed as vertical bar (|) characters.

Calling SetWindowText with any amount of text will cause the control to initialize to UNICODE. Calling SetWindowText with empty text will not cause the control to initialize to UNICODE.


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

See Also

GetWindowText | WM_SETTEXT | Windows Functions

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.