在Windows系统下的C++开发中，HWND是窗口的唯一标识句柄，通过它可以调用系统提供的API完成各类窗口操作，其中获取窗口标题是较为常见的需求，比如开发窗口管理工具、自动化脚本时都需要用到这个功能。
所需依赖与基础准备
要使用Windows API操作窗口，首先需要引入对应的头文件和链接系统库，核心依赖如下：
- 头文件：
windows.h，该头文件包含了所有Windows API的声明 - 链接库：User32.lib，窗口相关的API都封装在这个库中，大部分编译器会默认链接该库，若编译报错可手动添加链接选项
通过HWND获取窗口标题的核心方法
Windows系统提供了GetWindowText函数专门用于获取窗口标题，该函数有两个重载版本，分别用于获取文本长度和获取文本内容，完整使用流程如下：
第一步：获取窗口标题所需缓冲区长度
首先需要调用GetWindowTextLength函数获取窗口标题的字符长度，避免缓冲区分配过小导致内容截断，函数原型如下：
int GetWindowTextLength(HWND hWnd);参数hWnd就是目标窗口的句柄，返回值是对话框标题的字符数，不包含终止的空字符。如果返回0，可能是窗口句柄无效，或者窗口没有标题。
第二步：分配缓冲区并获取标题内容
根据获取到的长度分配字符缓冲区，然后调用GetWindowText函数获取标题，函数原型如下：
int GetWindowText(HWND hWnd, LPTSTR lpString, int nMaxCount);参数说明：
hWnd：目标窗口句柄lpString：接收标题的缓冲区指针nMaxCount：缓冲区的最大字符数，包含终止空字符
完整示例代码如下：
#include <windows.h>
#include <iostream>
#include <string>
// 通过HWND获取窗口标题的函数
std::wstring GetWindowTitleByHwnd(HWND hwnd) {
// 获取标题长度
int length = GetWindowTextLength(hwnd);
if (length == 0) {
return L"";
}
// 分配缓冲区，多分配1个位置存放终止空字符
wchar_t* buffer = new wchar_t[length + 1];
// 获取标题内容
GetWindowText(hwnd, buffer, length + 1);
std::wstring title(buffer);
delete[] buffer;
return title;
}
int main() {
// 示例：获取记事本窗口的标题，需要先打开一个记事本程序
// 这里通过FindWindow查找记事本窗口，实际场景中HWND可以通过其他方式获取
HWND notepadHwnd = FindWindow(L"Notepad", NULL);
if (notepadHwnd == NULL) {
std::wcout << L"未找到记事本窗口" << std::endl;
return 0;
}
std::wstring title = GetWindowTitleByHwnd(notepadHwnd);
std::wcout << L"窗口标题：" << title << std::endl;
return 0;
}
其他常用窗口操作API
除了获取窗口标题，还有一些常用的窗口操作API可以配合使用：
| API函数 | 功能说明 |
|---|---|
| FindWindow | 根据窗口类名或窗口标题查找窗口，返回对应的HWND |
| SetWindowText | 设置指定窗口的标题内容 |
| GetParent | 获取指定窗口的父窗口句柄 |
| IsWindow | 判断指定的HWND是否为有效的窗口句柄 |
| ShowWindow | 设置窗口的显示状态，比如最大化、最小化、隐藏等 |
注意事项
- 编码问题：Windows API默认使用宽字符（wchar_t），如果项目使用多字节编码，需要做编码转换，避免中文标题出现乱码
- 权限问题：如果目标窗口是管理员权限运行的，当前程序也需要以管理员权限运行才能正常获取窗口信息，否则可能返回空内容
- 句柄有效性：调用API前最好用
IsWindow函数判断HWND是否有效，避免传入无效句柄导致程序崩溃
注意：所有Windows API函数调用失败都会返回0或者NULL，可以通过GetLastError函数获取具体的错误码，方便排查问题。
C++HWNDWindows_APIGetWindowText修改时间：2026-07-12 15:36:30