SetWindowText

小甲鱼

注：本文档由 无符号整形 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

SetWindowText 函数用于改变指定窗口的标题栏（如果有的话）的文本。如果指定的窗口是一个控件，则修改控件的文本。

注意：SetWindowText 函数不能修改另一个应用程序中的控件的文本。


API 函数原型：

注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选的。

1. BOOL WINAPI SetWindowText(
   
2.   _In_     HWND    hWnd,
   
3.   _In_opt_ LPCTSTR lpString
   
4. );

复制代码

参数解析：

参数	含义
hWnd	指向需要修改文本的窗口或控件的句柄
lpString	指定新的标题或控件文本

返回值：

1. 如果函数成功，返回值是非 0；

2. 如果函数失败，返回值是 0。

获取有关错误的更多信息，请调用 GetLastError 函数。


备注：

1. 如果目标窗口是属于当前进程，SetWindowText 函数将发送 WM_SETTEXT 消息到指定的窗口或控件。如果创建的控件是一个拥有 WS_CAPTION 风格的列表框， SetWindowText 函数设置的是该控件的标题文本，不是列表框的项目文本。

2. 要设置另一个进程中的控件的文本，直接发送 WM_SETTEXT 消息而不是调用 SetWindowText 函数。

3. SetWindowText 函数不扩大 tab 字符（ASCII 码为 0x09）。制表符显示为竖线（|）字符。


需求：

Minimum supported client	Windows 2000 专业版 [仅桌面应用程序]
Minimum supported server	Windows 2000 服务器版 [仅桌面应用程序]
Header	Winuser.h (包含于 Windows.h)
Library	User32.lib
DLL	User32.dll
Unicode and ANSI names	SetWindowTextW (Unicode) 和 SetWindowTextA (ANSI)

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。