WinSetWindowText

This function sets the window text for a specified window.

Syntax

WinSetWindowText(hwnd, pszString)

Parameters

hwnd (HWND) - input: Window handle.
pszString (PSZ) - input: Window text.

Returns

rc (BOOL) - returns

Success indicator.

TRUE: Text updated

FALSE: Error occurred.

Errors

Possible returns from WinGetLastError

PMERR_INVALID_HWND (0x1001): An invalid window handle was specified.

Remarks

This function sends a WM_SETWINDOWPARAMS message to the window identified by hwnd.

If this function references the window of another process, pszString must be in memory that is shared by both processes; otherwise, a memory error may occur.

If hwnd has a style of WS_FRAME, the title-bar window text is set.

Some window classes interpret the pszString in a special way. The tilde character (~) indicates that the following character is a mnemonic; for details, see ?

Example Code

This example calls WinQuerySessionTitle to retrieve the application's title, and then sets the title bar of the frame window to that title with WinSetWindowText.

#define INCL_WINMESSAGEMGR
#define INCL_WINWINDOWMGR
#include <os2.h>

HAB hab;
HWND hwndFrame, hwndClient;
CHAR szTitle[MAXNAMEL + 1];

WinQuerySessionTitle(hab,
                     0, szTitle,
                     sizeof(szTitle));

hwndFrame = WinQueryWindow(hwndClient,
                           QW_PARENT); /* get handle of parent, */
                                       /* which is frame window. */
WinSetWindowText(hwndFrame, szTitle);

Related Functions

Related Messages

WM_SETWINDOWPARAMS