Magpie/docs/以编程方式与 Magpie 交互.md

Magpie 提供了和其他程序交互的机制。通过它们，你的应用可以和 Magpie 配合使用。

MagpieWatcher 演示了如何使用这些机制。

如何在缩放状态改变时得到通知

你应该监听 MagpieScalingChanged 消息。

UINT WM_MAGPIE_SCALINGCHANGED = RegisterWindowMessage(L"MagpieScalingChanged");

参数

wParam 为事件 ID，对于不同的事件 lParam 有不同的含义。支持以下事件：

• 0: 缩放已结束或源窗口失去焦点。缩放结束时 lParam 为 0，否则为 1。
• 1: 缩放已开始或源窗口回到前台。lParam 为缩放窗口句柄。
• 2: 缩放窗口位置或大小改变。窗口模式缩放时才会生成这个事件。
• 3: 用户开始调整缩放窗口大小或移动缩放窗口。窗口模式缩放时才会生成这个事件。

在调整缩放窗口大小或移动缩放窗口的过程中不会产生事件，但你可以定期检查窗口属性来获得更新的信息。

注意事项

如果你的进程完整性级别 (Integration level) 比 Magpie 更高，由于用户界面特权隔离 (UIPI)，你将无法收到 Magpie 广播的消息。这种情况下请调用 ChangeWindowMessageFilterEx 以允许接收 MagpieScalingChanged 消息。

ChangeWindowMessageFilterEx(hYourWindow, WM_MAGPIE_SCALINGCHANGED, MSGFLT_ADD, nullptr);

如何获取缩放窗口句柄

你可以监听 MagpieScalingChanged 消息来获取缩放窗口句柄，也可以查找类名为Window_Magpie_967EB565-6F73-4E94-AE53-00CC42592A22的窗口以在缩放中途获取该句柄。Magpie 将确保此类名不会改变，且不会同时存在多个缩放窗口。

HWND hwndScaling = FindWindow(L"Window_Magpie_967EB565-6F73-4E94-AE53-00CC42592A22", nullptr);

如何将你的窗口置于缩放窗口上方

你应该监听 MagpieScalingChanged 消息，根据事件调整自己的 Z 轴顺序。下面是一个简单的示例，更复杂的用例参见 MagpieWatcher。

if (message == WM_MAGPIE_SCALINGCHANGED) {
    if (wParam == 0) {
        // 取消置顶
        SetWindowPos(hWnd, HWND_NOTOPMOST, 0, 0, 0, 0, SWP_NOSIZE | SWP_NOMOVE);
    } else if (wParam == 1) {
        // 确保本窗口在缩放窗口上面
        SetWindowPos(hWnd, HWND_TOPMOST, 0, 0, 0, 0, SWP_NOSIZE | SWP_NOMOVE);
    }
}

如何获取缩放信息

缩放窗口的窗口属性中存储着缩放信息。目前支持以下属性：

• Magpie.Windowed：是否处于窗口模式缩放
• Magpie.SrcHWND: 源窗口句柄
• Magpie.SrcLeft、Magpie.SrcTop、Magpie.SrcRight、Magpie.SrcBottom: 被缩放区域的边界
• Magpie.DestLeft、Magpie.DestTop、Magpie.DestRight、Magpie.DestBottom: 缩放后区域矩形边界

HWND hwndSrc = (HWND)GetProp(hwndScaling, L"Magpie.SrcHWND");
bool isWindowed = (bool)GetProp(hwndScaling, L"Magpie.Windowed");

RECT srcRect;
srcRect.left = (LONG)(INT_PTR)GetProp(hwndScaling, L"Magpie.SrcLeft");
srcRect.top = (LONG)(INT_PTR)GetProp(hwndScaling, L"Magpie.SrcTop");
srcRect.right = (LONG)(INT_PTR)GetProp(hwndScaling, L"Magpie.SrcRight");
srcRect.bottom = (LONG)(INT_PTR)GetProp(hwndScaling, L"Magpie.SrcBottom");

RECT destRect;
destRect.left = (LONG)(INT_PTR)GetProp(hwndScaling, L"Magpie.DestLeft");
destRect.top = (LONG)(INT_PTR)GetProp(hwndScaling, L"Magpie.DestTop");
destRect.right = (LONG)(INT_PTR)GetProp(hwndScaling, L"Magpie.DestRight");
destRect.bottom = (LONG)(INT_PTR)GetProp(hwndScaling, L"Magpie.DestBottom");

注意事项

1. 这些属性只在缩放窗口初始化完成后才保证存在，因此建议检索属性前检查缩放窗口是否可见，尤其是当窗口句柄是使用类名获取到的。
2. 这些属性中存储的坐标不受 DPI 虚拟化影响，你需要将程序的 DPI 感知级别设置为 Per-Monitor V2 才能正确使用它们。有关详细信息，请参阅 High DPI Desktop Application Development on Windows。