 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
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.
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, SetWindowTextcauses a WM_SETTEXTmessage to be sent to the specified window or control. If the control is a list box control created with the WS_CAPTION style, however, SetWindowTextsets the text for the control, not for the list box entries.
The SetWindowTextfunction 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