SetWindowText Function

Declare Function SetWindowText Lib "user32.dll" Alias "SetWindowTextA" (ByVal hWnd As Long, ByVal lpString As String) As Long

Platforms

Windows 95: Supported.
Windows 98: Supported.
Windows NT: Requires Windows NT 3.1 or later.
Windows 2000: Supported.
Windows CE: Requires Windows CE 1.0 or later.

Description & Usage

SetWindowText changes the text of a given window. Although this function can set the text of regular windows owned by other programs, it cannot change the text of a control owned by a different program. To set the text of those controls, use the WM_SETTEXT message instead.

Return Value

If an error occured, the function returns 0 (use GetLastError to get the error code). If successful, the function returns a non-zero value.

Parameters

hWnd: A handle to the window to set the text of.
lpString: The string to set as the window's text.

Example

' This code is licensed according to the terms and conditions listed here.

' Set the title bar of window Form1 to "Generic Application 1.0".
Dim retval As Long  ' return value

retval = SetWindowText(Form1.hWnd, "Generic Application 1.0")