Merge branch 'main' into dev

Blinue · Jun 5, 2024 · b6f5da2 · b6f5da2
2 parents 447075b + 7ff2dca
commit b6f5da2
Show file tree

Hide file tree

Showing 5 changed files with 15 additions and 29 deletions.
diff --git a/docs/Home (EN).md b/docs/Home (EN).md
@@ -1,15 +1,3 @@
-# Magpie Wiki
+[Chinese version](https://github.com/Blinue/Magpie/wiki/)
 
-Welcome to the Magpie Wiki. Please read [Contributing](https://github.com/Blinue/Magpie/blob/main/CONTRIBUTING_EN.md) if you'd like to contribute the the documentations.
-
-[FAQ](https://github.com/Blinue/Magpie/wiki/FAQ%20(EN))
-
-[Compilation guide](https://github.com/Blinue/Magpie/wiki/Compilation%20guide)
-
-[Built-in effects](https://github.com/Blinue/Magpie/wiki/Built-in%20effects)
-
-[MagpieFX](https://github.com/Blinue/Magpie/wiki/MagpieFX%20(EN))
-
-[Performance optimization](https://github.com/Blinue/Magpie/wiki/Performance%20optimization)
-
-[Comparison of capture methods](https://github.com/Blinue/Magpie/wiki/Comparison%20of%20capture%20methods)
+Welcome to the Magpie Wiki. Please read [CONTRIBUTING](https://github.com/Blinue/Magpie/blob/dev/CONTRIBUTING.md) if you'd like to contribute the the documentations.
diff --git a/docs/Home.md b/docs/Home.md
@@ -1,17 +1,3 @@
-# Magpie Wiki
-
-欢迎来到 Magpie Wiki。如果你想贡献文档，请阅读[贡献指南](https://github.com/Blinue/Magpie/blob/main/CONTRIBUTING.md#%E6%88%91%E6%83%B3%E8%B4%A1%E7%8C%AE%E6%96%87%E6%A1%A3-)。
-
 [English version](https://github.com/Blinue/Magpie/wiki/Home%20(EN))
 
-[FAQ](https://github.com/Blinue/Magpie/wiki/FAQ)
-
-[编译指南](https://github.com/Blinue/Magpie/wiki/编译指南)
-
-[内置效果介绍](https://github.com/Blinue/Magpie/wiki/内置效果介绍)
-
-[MagpieFX](https://github.com/Blinue/Magpie/wiki/MagpieFX)
-
-[性能优化建议](https://github.com/Blinue/Magpie/wiki/性能优化建议)
-
-[捕获方式对比](https://github.com/Blinue/Magpie/wiki/捕获方式对比)
+欢迎来到 Magpie Wiki。如果你想贡献文档，请阅读[贡献指南](https://github.com/Blinue/Magpie/blob/main/CONTRIBUTING_ZH.md#%E6%88%91%E6%83%B3%E8%B4%A1%E7%8C%AE%E6%96%87%E6%A1%A3-)。
diff --git a/docs/Interact with Magpie programally.md b/docs/Interact with Magpie programally.md
@@ -80,6 +80,10 @@ destRect.right = (LONG)(INT_PTR)GetProp(hwndScaling, L"Magpie.DestRight");
 destRect.bottom = (LONG)(INT_PTR)GetProp(hwndScaling, L"Magpie.DestBottom");
 ```
 
+### Notes
+
+These properties are only guaranteed to exist after the scaling window has completed its initialization. Therefore, it is advisable to check whether the scaling window is visible before retrieving these properties, especially when the window handle is obtained using the class name.
+
 ## 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.

diff --git a/docs/_Sidebar.md b/docs/_Sidebar.md
@@ -5,6 +5,8 @@
   - [MagpieFX](https://github.com/Blinue/Magpie/wiki/MagpieFX)
   - [性能优化建议](https://github.com/Blinue/Magpie/wiki/性能优化建议)
   - [捕获方式对比](https://github.com/Blinue/Magpie/wiki/捕获方式对比)
+  - [关于触控支持](https://github.com/Blinue/Magpie/wiki/关于触控支持)
+  - [以编程方式与 Magpie 交互](https://github.com/Blinue/Magpie/wiki/以编程方式与-Magpie-交互)
 
 - [WIKI HOME](https://github.com/Blinue/Magpie/wiki/Home%20(EN))
   - [FAQ](https://github.com/Blinue/Magpie/wiki/FAQ%20(EN))
@@ -13,3 +15,5 @@
   - [MagpieFX](https://github.com/Blinue/Magpie/wiki/MagpieFX%20(EN))
   - [Performance optimization](https://github.com/Blinue/Magpie/wiki/Performance%20optimization)
   - [Comparison of capture methods](https://github.com/Blinue/Magpie/wiki/Comparison%20of%20capture%20methods)
+  - [About touch support](https://github.com/Blinue/Magpie/wiki/About-touch-support)
+  - [Interact with Magpie programally](https://github.com/Blinue/Magpie/wiki/Interact-with-Magpie-programally)
diff --git a/docs/以编程方式与 Magpie 交互.md b/docs/以编程方式与 Magpie 交互.md
@@ -80,6 +80,10 @@ 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) 的窗口也有效。