-
Notifications
You must be signed in to change notification settings - Fork 459
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
204 changed files
with
5,399 additions
and
4,084 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| !*.pfx |
Binary file not shown.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,13 @@ | ||
| Due to OS security restrictions, Magpie requires UIAccess privileges to support touch input. Obtaining this privilege necessitates meeting two conditions: | ||
|
|
||
| 1. The application must possess a digital signature, and this signature must be verified by a certificate associated with a trusted root certificate authority store on the local machine. | ||
| 2. The application must reside in a "secure location", such as the Program Files or System32 folders. | ||
|
|
||
| When enabling touch support, Magpie performs the following actions: | ||
|
|
||
| 1. Adds a self-signed certificate to the trusted root certificate authority store. | ||
| 2. Copies the TouchHelper.exe to `System32\Magpie`. During scaling, Magpie runs this program to enable touch support. | ||
|
|
||
| Both of these actions constitute significant changes to the OS, thus requiring administrator privileges. If touch support is no longer needed, this option should be disabled. Magpie will then revert these changes, leaving no traces in the OS. | ||
|
|
||
| Touch support may fail for various reasons, such as when TouchHelper.exe requires an update. In such cases, Magpie will request administrator privileges before scaling to resolve the issue. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,89 @@ | ||
| Magpie provides mechanisms for interaction with other programs. Through these mechanisms, your application can cooperate with Magpie. | ||
|
|
||
| [MagpieWatcher](https://github.com/Blinue/MagpieWatcher) demonstrates how to use these mechanisms. | ||
|
|
||
| ## How to Receive Notifications When Scaling State Changes | ||
|
|
||
| You should listen for the MagpieScalingChanged message. | ||
|
|
||
| ```c++ | ||
| UINT WM_MAGPIE_SCALINGCHANGED = RegisterWindowMessage(L"MagpieScalingChanged"); | ||
| ``` | ||
|
|
||
| ### Parameters | ||
|
|
||
| `wParam` is the event ID. For different events, `lParam` has different meanings. Currently, two events are supported: | ||
|
|
||
| * 0: Scaling has ended. `lParam` is not used. | ||
| * 1: Scaling has started. `lParam` is the handle of the scaling window. | ||
|
|
||
| ### Notes | ||
|
|
||
| If your process has a higher integrity level than Magpie, you won't receive messages broadcasted by Magpie due to User Interface Privilege Isolation (UIPI). In such cases, call [ChangeWindowMessageFilterEx](https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-changewindowmessagefilterex) to allow receiving the MagpieScalingChanged message. | ||
|
|
||
| ```c++ | ||
| ChangeWindowMessageFilterEx(hYourWindow, WM_MAGPIE_SCALINGCHANGED, MSGFLT_ADD, nullptr); | ||
| ``` | ||
| ## How to Get the Handle of the Scaling Window | ||
| You can listen for the MagpieScalingChanged message to obtain the handle of the scaling window. Additionally, while Magpie is scaling, you can also search for the window with the class name `Window_Magpie_967EB565-6F73-4E94-AE53-00CC42592A22`. Magpie ensures that this class name remains unchanged and that only one scaling window exists at a time. | ||
| ```c++ | ||
| HWND hwndScaling = FindWindow(L"Window_Magpie_967EB565-6F73-4E94-AE53-00CC42592A22", nullptr); | ||
| ``` | ||
|
|
||
| ## How to Place Your Window Above the Scaling Window | ||
|
|
||
| Your window must be topmost. You should also listen for the MagpieScalingChanged message; you will receive one after the scaling window is shown, and then you can use `BringWindowToTop` to place your window above it. The scaling window does not attempt to adjust its position on the Z-axis while it exists. | ||
|
|
||
| ```c++ | ||
| HWND hWnd = CreateWindowEx(WS_EX_TOPMOST, ...); | ||
| ... | ||
| if (message == WM_MAGPIE_SCALINGCHANGED) { | ||
| switch (wParam) { | ||
| case 0: | ||
| // Scaling has ended | ||
| break; | ||
| case 1: | ||
| // Scaling has started | ||
| // Place this window above the scaling window | ||
| BringWindowToTop(hWnd); | ||
| break; | ||
| default: | ||
| break; | ||
| } | ||
| } | ||
| ``` | ||
|
|
||
| ## How to Obtain Scaling Information | ||
|
|
||
| Scaling information is stored in the [window properties](https://learn.microsoft.com/en-us/windows/win32/winmsg/about-window-properties) of the scaling window. Currently available properties include: | ||
|
|
||
| * `Magpie.SrcHWND`: Handle of the source window | ||
| * `Magpie.SrcLeft`、`Magpie.SrcTop`、`Magpie.SrcRight`、`Magpie.SrcBottom`: Source region of scaling | ||
| * `Magpie.DestLeft`、`Magpie.DestTop`、`Magpie.DestRight`、`Magpie.DestBottom`: Destination region of scaling | ||
|
|
||
| ```c++ | ||
| HWND hwndSrc = (HWND)GetProp(hwndScaling, L"Magpie.SrcHWND"); | ||
|
|
||
| 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"); | ||
| ``` | ||
|
|
||
| ## How to Keep Magpie Scaling When Your Window Is in the Foreground | ||
|
|
||
| Magpie stops scaling when the foreground window changes, with some system windows being exceptions. By setting the `Magpie.ToolWindow` property, you can include your window and all its owned windows in the exceptions list. | ||
|
|
||
| ```c++ | ||
| SetProp(hYourWindow, L"Magpie.ToolWindow", (HANDLE)TRUE); | ||
| ``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,89 @@ | ||
| Magpie 提供了和其他程序交互的机制。通过它们，你的应用可以和 Magpie 配合使用。 | ||
|
|
||
| [MagpieWatcher](https://github.com/Blinue/MagpieWatcher) 演示了如何使用这些机制。 | ||
|
|
||
| ## 如何在缩放状态改变时得到通知 | ||
|
|
||
| 你应该监听 MagpieScalingChanged 消息。 | ||
|
|
||
| ```c++ | ||
| UINT WM_MAGPIE_SCALINGCHANGED = RegisterWindowMessage(L"MagpieScalingChanged"); | ||
| ``` | ||
|
|
||
| ### 参数 | ||
|
|
||
| `wParam` 为事件 ID，对于不同的事件 `lParam` 有不同的含义。目前支持两个事件： | ||
|
|
||
| * 0: 缩放已结束。不使用 `lParam`。 | ||
| * 1: 缩放已开始。`lParam` 为缩放窗口句柄。 | ||
|
|
||
| ### 注意事项 | ||
|
|
||
| 如果你的进程完整性级别 (Integration level) 比 Magpie 更高，由于用户界面特权隔离 (UIPI)，你将无法收到 Magpie 广播的消息。这种情况下请调用 [ChangeWindowMessageFilterEx](https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-changewindowmessagefilterex) 以允许接收 MagpieScalingChanged 消息。 | ||
|
|
||
| ```c++ | ||
| ChangeWindowMessageFilterEx(hYourWindow, WM_MAGPIE_SCALINGCHANGED, MSGFLT_ADD, nullptr); | ||
| ``` | ||
| ## 如何获取缩放窗口句柄 | ||
| 你可以监听 MagpieScalingChanged 消息来获取缩放窗口句柄，也可以查找类名为`Window_Magpie_967EB565-6F73-4E94-AE53-00CC42592A22`的窗口以在缩放中途获取该句柄。Magpie 将确保此类名不会改变，且不会同时存在多个缩放窗口。 | ||
| ```c++ | ||
| HWND hwndScaling = FindWindow(L"Window_Magpie_967EB565-6F73-4E94-AE53-00CC42592A22", nullptr); | ||
| ``` | ||
|
|
||
| ## 如何将你的窗口置于缩放窗口上方 | ||
|
|
||
| 你的窗口必须是置顶的。你还应该监听 MagpieScalingChanged 消息，当收到该消息时缩放窗口已经显示，然后你可以使用 `BringWindowToTop` 函数将自己的窗口置于缩放窗口上方。缩放窗口在存在期间不会尝试调整自己在 Z 轴的位置。 | ||
|
|
||
| ```c++ | ||
| HWND hWnd = CreateWindowEx(WS_EX_TOPMOST, ...); | ||
| ... | ||
| if (message == WM_MAGPIE_SCALINGCHANGED) { | ||
| switch (wParam) { | ||
| case 0: | ||
| // 缩放已结束 | ||
| break; | ||
| case 1: | ||
| // 缩放已开始 | ||
| // 将本窗口置于缩放窗口上面 | ||
| BringWindowToTop(hWnd); | ||
| break; | ||
| default: | ||
| break; | ||
| } | ||
| } | ||
| ``` | ||
|
|
||
| ## 如何获取缩放信息 | ||
|
|
||
| 缩放窗口的[窗口属性](https://learn.microsoft.com/en-us/windows/win32/winmsg/about-window-properties)中存储着缩放信息。目前支持以下属性： | ||
|
|
||
| * `Magpie.SrcHWND`: 源窗口句柄 | ||
| * `Magpie.SrcLeft`、`Magpie.SrcTop`、`Magpie.SrcRight`、`Magpie.SrcBottom`: 被缩放区域的边界 | ||
| * `Magpie.DestLeft`、`Magpie.DestTop`、`Magpie.DestRight`、`Magpie.DestBottom`: 缩放后区域矩形边界 | ||
|
|
||
| ```c++ | ||
| HWND hwndSrc = (HWND)GetProp(hwndScaling, L"Magpie.SrcHWND"); | ||
|
|
||
| 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"); | ||
| ``` | ||
|
|
||
| ## 如何使 Magpie 在你的窗口位于前台时保持缩放 | ||
|
|
||
| 前台窗口改变时 Magpie 会停止缩放，只对某些系统窗口例外。你可以通过设置属性 `Magpie.ToolWindow` 将自己的窗口添加入例外，这对由该窗口拥有 (owned) 的窗口也有效。 | ||
|
|
||
| ```c++ | ||
| SetProp(hYourWindow, L"Magpie.ToolWindow", (HANDLE)TRUE); | ||
| ``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,13 @@ | ||
| 由于操作系统的安全限制，Magpie 需要 UIAccess 权限来支持触控输入。获得此权限需要满足两个条件： | ||
|
|
||
| 1. 应用程序必须有一个数字签名，且该签名能够通过与本地计算机上受信任的根证书颁发机构存储相关联的证书来验证。 | ||
| 2. 应用程序必须位于“安全位置”，例如 Program Files、System32 等文件夹中。 | ||
|
|
||
| 启用触控支持时，Magpie 将进行以下操作： | ||
|
|
||
| 1. 向受信任的根证书颁发机构存储添加自签名证书。 | ||
| 2. 将 TouchHelper.exe 文件复制到 `System32\Magpie` 文件夹。在缩放时，Magpie 会运行此程序以实现触控支持。 | ||
|
|
||
| 这两项操作都对操作系统构成重大更改，因此需要管理员权限。如果不再需要触控支持，应关闭此选项，Magpie 会撤销这些更改，不在操作系统中留下痕迹。 | ||
|
|
||
| 触控支持可能会因为某些原因失效（比如 TouchHelper.exe 需要更新时），如果发生这种情况，Magpie 会在缩放前请求管理员权限来修复它。 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.