Share via

SetWindowText

  • Article
  • 06/30/2006

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

BOOL SetWindowText( 
HWND hWnd, 
LPCTSTR lpString );

Parameters

  • hWnd
    Handle to the window or control whose text is to be changed.
  • lpString
    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.

Remarks

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.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Winuser.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

GetWindowText, WM_SETTEXT

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.