解决 Windows 截屏黑框终极指南 | 附 C++ 代码示例

2024-12-14 13:16:46

好的，下面是一篇关于解决 Windows 截屏工具和 WindowsGraphicsCapture 生成黑框问题的技术博客文章。

Windows 截屏黑框问题解析与解决方案

在使用 Windows 截屏工具或 WindowsGraphicsCapture API 时，有时会遇到特定窗口显示为黑框的问题。即使已使用 SetWindowDisplayAffinity 函数将窗口排除在截屏范围之外，窗口的隐藏和重新显示操作仍然可能导致截屏区域出现黑色矩形。本文深入分析此问题，并提供多种解决方案。

问题原因分析

该问题主要出现在使用 SetWindowDisplayAffinity(hWnd, WDA_EXCLUDEFROMCAPTURE) 排除窗口截屏，并结合 ShowWindow(hWnd, SW_HIDE) 和 ShowWindow(hWnd, SW_SHOW) 控制窗口显示隐藏的情况下。根本原因可能是 Windows 系统在处理窗口显示隐藏和截屏排除的交互时存在缺陷。当窗口被隐藏然后再次显示时，系统可能未能正确地更新窗口的截屏排除状态，导致截屏时该区域被渲染为黑色。

解决方案

以下是几种解决此问题的方法：

1. 避免使用 ShowWindow 控制显示隐藏

不直接使用 ShowWindow 函数控制窗口的显示和隐藏，而是通过移动窗口位置的方式实现类似效果。将窗口移出屏幕可视区域来“隐藏”窗口，再移回原位置来“显示”窗口。这种方法可以规避系统在处理窗口显示隐藏状态时可能出现的错误。

代码示例 (C++)：

// 隐藏窗口
RECT rect;
GetWindowRect(hWnd, &rect);
int width = rect.right - rect.left;
int height = rect.bottom - rect.top;
SetWindowPos(hWnd, NULL, -width, -height, width, height, SWP_NOZORDER | SWP_NOACTIVATE);

// 显示窗口
SetWindowPos(hWnd, NULL, rect.left, rect.top, width, height, SWP_NOZORDER | SWP_NOACTIVATE);

操作步骤:

获取窗口的当前位置和大小。
使用 SetWindowPos 函数将窗口移动到屏幕外，比如设置其坐标为负值，且坐标绝对值大于窗口尺寸，实现隐藏效果。
使用 SetWindowPos 函数将窗口恢复到原始位置，实现显示效果。 SWP_NOZORDER 和 SWP_NOACTIVATE 标志确保窗口位置改变时不影响 Z 轴顺序和活动状态。

2. 强制刷新窗口区域

在窗口显示后，强制刷新窗口及其父窗口区域，确保系统正确渲染窗口内容，并更新截屏排除状态。

代码示例 (C++)：

ShowWindow(hWnd, SW_SHOW);
RedrawWindow(hWnd, NULL, NULL, RDW_INVALIDATE | RDW_UPDATENOW | RDW_ALLCHILDREN);
UpdateWindow(hWnd);

HWND hParentWnd = GetParent(hWnd);
if (hParentWnd) {
    RedrawWindow(hParentWnd, NULL, NULL, RDW_INVALIDATE | RDW_UPDATENOW | RDW_ALLCHILDREN);
     UpdateWindow(hParentWnd);
}

操作步骤：

调用 ShowWindow(hWnd, SW_SHOW) 显示窗口。
使用 RedrawWindow 函数强制刷新窗口区域， RDW_INVALIDATE 标志使整个窗口区域无效， RDW_UPDATENOW 标志立即更新窗口，RDW_ALLCHILDREN 标志刷新所有子窗口。
调用 UpdateWindow 函数确保窗口立即重绘。
获取父窗口句柄 hParentWnd，如果存在父窗口，则同样刷新父窗口区域。

3. 延迟截屏操作

在窗口显示后，稍作延迟再执行截屏操作。给系统足够的时间来处理窗口显示和截屏排除状态的更新。

代码示例 (C++)：

ShowWindow(hWnd, SW_SHOW);
Sleep(50);  // 延迟 50 毫秒，具体时间可根据实际情况调整
// 执行截屏操作

操作步骤:

调用 ShowWindow(hWnd, SW_SHOW) 显示窗口。
使用 Sleep 函数暂停一段时间。
调用截屏相关的 API 进行截屏操作。

安全建议：
* 避免过长的延迟时间，以免影响用户体验。
* 根据实际情况调整延迟时间，找到一个合适的平衡点，保证截屏效果的同时，避免过长的延迟。

4. 使用 SetWindowPos 代替 ShowWindow

使用 SetWindowPos 函数直接控制窗口的显示和隐藏，通过调整窗口大小为零或原始大小来实现类似效果，同时还能更好地控制窗口的 Z 轴顺序。

代码示例 (C++)：

 // 隐藏窗口
SetWindowPos(hWnd, NULL, 0, 0, 0, 0, SWP_NOZORDER | SWP_NOACTIVATE | SWP_HIDEWINDOW);

// 显示窗口
 RECT rect;
GetWindowRect(hWnd, &rect);
 int width = rect.right - rect.left;
int height = rect.bottom - rect.top;
 SetWindowPos(hWnd, NULL, rect.left, rect.top, width, height, SWP_NOZORDER | SWP_NOACTIVATE | SWP_SHOWWINDOW);

操作步骤:

使用 SetWindowPos 函数，设置窗口宽高为 0, 并指定 SWP_HIDEWINDOW 标志来隐藏窗口。 SWP_NOZORDER 和 SWP_NOACTIVATE 标志确保窗口位置改变时不影响 Z 轴顺序和活动状态。
获取窗口原始大小，使用 SetWindowPos 函数恢复窗口原始大小，并指定 SWP_SHOWWINDOW 标志显示窗口。