diff --git a/README.md b/README.md
index c93869d..9db57af 100644
--- a/README.md
+++ b/README.md
@@ -25,7 +25,7 @@
#### [截图](https://winui.net/)
-![WinUi++](https://winui.net/intro/images/01.png)
+![WinUi++](https://winui.net/introduction/images/01.png)
* 开发版文档:https://shelllet.github.io/winui/#/
diff --git a/docx/CHANGELOG.md b/docx/CHANGELOG.md
index 7491380..a82b0e9 100644
--- a/docx/CHANGELOG.md
+++ b/docx/CHANGELOG.md
@@ -1,4 +1,18 @@
-# [0.30](https://github.com/shelllet/winui/compare/main...dev) (2023-11-10)
+# [0.30](https://github.com/shelllet/winui/compare/main...dev) (2023-xx-xx)
+
+### Changed:
+
+1. *工作线程* 动作支持选择是否立即运行。
+2. *监听鼠标* 动作支持鼠标侧键。
+
+### Deprecated:
+
+1. *前置窗口截图* 动作弃用,请使用 [*窗口截图*](./actions/media/CaptureWindow.md) 动作。
+### 备注
+
+1. 下载:
+
+## [0.30](https://github.com/shelllet/winui/compare/main...dev) (2023-11-10)
### 变更:
diff --git a/docx/README.md b/docx/README.md
index 22fcb4b..6f676d5 100644
--- a/docx/README.md
+++ b/docx/README.md
@@ -25,7 +25,7 @@
#### [截图](https://winui.net/)
-![WinUi++](https://winui.net/intro/images/01.png)
+![WinUi++](https://winui.net/introduction/images/01.png)
* 开发版文档:https://shelllet.github.io/winui/#/
@@ -37,10 +37,4 @@
* 油管: [https://www.youtube.com/playlist?list=UULFs1P87PQvBDJAuJfkKRLqMQ](https://www.youtube.com/playlist?list=UULFs1P87PQvBDJAuJfkKRLqMQ)
* B站:[https://space.bilibili.com/652005178/channel/collectiondetail?sid=84951](https://space.bilibili.com/652005178/channel/collectiondetail?sid=84951)
-* 加入 [Discord](https://discord.gg/b4MeYbJrfk) 讨论。
-
-* 扫下面二维码加入微信群.
-
-
-
-
+* 加入 [Discord](https://discord.gg/b4MeYbJrfk) 讨论。
\ No newline at end of file
diff --git a/docx/_navbar.md b/docx/_navbar.md
index 35ea330..49fd366 100644
--- a/docx/_navbar.md
+++ b/docx/_navbar.md
@@ -1,6 +1,6 @@
* 文档
- * [介绍](./intro/README.md.md)
+ * [介绍](./introduction/README.md.md)
* [开发版](https://shelllet.github.io/winui/#/ ':id=dev')
* [发布版](https://winui.net/#/ ':id=rel')
* [更新日志](./CHANGELOG.md)
diff --git a/docx/_sidebar.md b/docx/_sidebar.md
index 71992b4..93a4802 100644
--- a/docx/_sidebar.md
+++ b/docx/_sidebar.md
@@ -1,17 +1,17 @@
- [WinUi++](/)
- - [简介](./intro/README.md)
+ - [简介](./introduction/README.md)
- 安装
- - [直接安装](./intro/installation/installed_by_exe.md)
- - [微软商店安装](./intro/installation/installed_by_msix.md)
- - [安装问题](./intro/installation/questions.md)
+ - [直接安装](./introduction/installation/installed_by_exe.md)
+ - [微软商店安装](./introduction/installation/installed_by_msix.md)
+ - [安装问题](./introduction/installation/questions.md)
- 流程
- - [项目属性](./intro/workflow/property.md)
- - [使用逻辑](./intro/workflow/logic.md)
- - [鼠标/键盘录制](./intro/workflow/record.md)
- - [变量](./intro/workflow/variable.md)
- - [流程操作技巧](./intro/workflow/skill.md)
- - [通配符匹配](./intro/workflow/wildcard.md)
- - [Glob模式匹配](./intro/workflow/glob.md)
+ - [项目属性](./introduction/workflow/property.md)
+ - [使用逻辑](./introduction/workflow/logic.md)
+ - [鼠标/键盘宏录制](./introduction/workflow/macro_record.md)
+ - [变量](./introduction/workflow/variable.md)
+ - [流程操作技巧](./introduction/workflow/skill.md)
+ - [通配符匹配](./introduction/workflow/wildcard.md)
+ - [Glob模式匹配](./introduction/workflow/glob.md)
- [动作](./actions/README.md)
- 系统
- [等待](./actions/system/Wait.md)
@@ -112,10 +112,9 @@
- [二维码识别](./actions/dnn/QRCode.md)
- 媒体
- [窗口截图](./actions/media/CaptureWindow.md)
- - [声音播放](./actions/media/MediaPlay.md)
- - [播放录制](./actions/media/PlayRecord.md)
- [全屏截图](./actions/media/CaptureFullScreen.md)
- - [前置窗口截图](./actions/media/CaptureForground.md)
+ - [声音播放](./actions/media/MediaPlay.md)
+ - [键盘/鼠标宏重放](./actions/media/PlayRecord.md)
- [相机图像](./actions/media/VideoFrame.md)
- 网络
- [下载](./actions/network/HttpDownload.md)
diff --git a/docx/actions/algorithm/FilterText.md b/docx/actions/algorithm/FilterText.md
index 90de35b..403e73c 100644
--- a/docx/actions/algorithm/FilterText.md
+++ b/docx/actions/algorithm/FilterText.md
@@ -11,7 +11,7 @@
* Value: 含有文本的列表,例如 *文字识别* 动作。
-* [Text](./types/String.md): 文本,*字符串* 类型, 支持 [*通配符(WildCard)*](./intro/process/wildcard.md) 匹配。
+* [Text](./types/String.md): 文本,*字符串* 类型, 支持 [*通配符(WildCard)*](./introduction/process/wildcard.md) 匹配。
## 输出
diff --git a/docx/actions/algorithm/FilterWindows.md b/docx/actions/algorithm/FilterWindows.md
index 94ec43c..3ecfdba 100644
--- a/docx/actions/algorithm/FilterWindows.md
+++ b/docx/actions/algorithm/FilterWindows.md
@@ -11,7 +11,7 @@
## 运行参数
* Windows: 窗口列表。
-* Title: 窗口标题。支持 [**通配符(WildCard)**)](./intro/process/wildcard.md)匹配。
+* Title: 窗口标题。支持 [**通配符(WildCard)**)](./introduction/process/wildcard.md)匹配。
* Name: 窗口类名。
## 输出
diff --git a/docx/actions/async/WorkThread.md b/docx/actions/async/WorkThread.md
index b8cf4c6..f8b78e9 100644
--- a/docx/actions/async/WorkThread.md
+++ b/docx/actions/async/WorkThread.md
@@ -12,6 +12,8 @@
## 运行参数
+* 手动
+> 线程默认状态开始即运行,如果选中此参数,线程一开始则不会执行,需要配合使用其它动作使其运行。
## 输出
diff --git a/docx/actions/filesystem/FileQuery.md b/docx/actions/filesystem/FileQuery.md
index 6fe7792..2f51891 100644
--- a/docx/actions/filesystem/FileQuery.md
+++ b/docx/actions/filesystem/FileQuery.md
@@ -12,7 +12,7 @@
## 运行参数
* [path](./types/String.md)
- > 搜索路径。支持 *glob* 匹配。默认值 `*`,从当前目录查找所有文件。 参考:[Glob模式匹配](./intro/workflow/glob.md)
+ > 搜索路径。支持 *glob* 匹配。默认值 `*`,从当前目录查找所有文件。 参考:[Glob模式匹配](./introduction/workflow/glob.md)
* [options](./enums/GlobOptions.md)
> 匹配行为
diff --git a/docx/actions/media/CaptureForground.md b/docx/actions/media/CaptureForground.md
deleted file mode 100644
index 082bd2f..0000000
--- a/docx/actions/media/CaptureForground.md
+++ /dev/null
@@ -1,25 +0,0 @@
-# 前置窗口截图
-前置窗口截图。
-
-## 子流程
-> 不支持
-
-
-## 运行参数
-
-
-
-
-## 输出
-
-> 图像
-
-
-## 脚本调用
-
-```python
-import simple;
-
-```
-
-## 示例
\ No newline at end of file
diff --git a/docx/actions/media/CaptureFullScreen.md b/docx/actions/media/CaptureFullScreen.md
index 3775ff5..d4dd2ec 100644
--- a/docx/actions/media/CaptureFullScreen.md
+++ b/docx/actions/media/CaptureFullScreen.md
@@ -1,18 +1,23 @@
# 全屏截图
全屏截图
+![CaptureFullScreen](./images/02.png ':size=90%')
+
## 子流程
> 不支持
## 运行参数
-
+* 中心
+> 要选择的 *ROI* 区域中心位置,*ROI* 区域之外,图像将置为黑色。
+* 尺寸
+> 要选择的 *ROI* 区域的长宽。*ROI* 区域之外,图像将置为黑色。
## 输出
-> 屏幕图像
+> 图像,参考:[`Image`](./types/Image.md)
## 脚本调用
@@ -22,4 +27,6 @@ import simple;
```
-## 示例
\ No newline at end of file
+## 资源
+
+示例:https://github.com/shelllet/WinUi/blob/main/media/CaptureFullScreen.simple
diff --git a/docx/actions/media/CaptureWindow.md b/docx/actions/media/CaptureWindow.md
index 87245f8..726939f 100644
--- a/docx/actions/media/CaptureWindow.md
+++ b/docx/actions/media/CaptureWindow.md
@@ -1,18 +1,23 @@
# 窗口截图
-此动作用来对指定的窗口进行截图
+根据指定的窗口截图,此图像包含标题栏。
-![CaptureWindow](./images/2022-11-27_144417.png ':size=90%')
+![CaptureWindow](./images/01.png ':size=90%')
## 子流程
> 不支持
## 运行参数
-* Window: 用来截图的窗口。
+* 窗口
+> 需要截图的窗口。如果为 *空* ,选择当前激活的前置窗口。
+* 中心
+> 要选择的 *ROI* 区域中心位置,*ROI* 区域之外,图像将置为黑色。
+* 尺寸
+> 要选择的 *ROI* 区域的长宽。*ROI* 区域之外,图像将置为黑色。
## 输出
-> [`Image`](./types/Image.md)
+> 图像,参考:[`Image`](./types/Image.md)
## 脚本调用
@@ -22,7 +27,7 @@ import simple;
```
-## 示例
+## 资源
-[https://github.com/shelllet/WinUi/blob/main/media/capture_window.simple](https://github.com/shelllet/WinUi/blob/main/media/capture_window.simple)
+示例:https://github.com/shelllet/WinUi/blob/main/media/CaptureWindow.simple
diff --git a/docx/actions/media/MediaPlay.md b/docx/actions/media/MediaPlay.md
index 7866e4c..555cfb9 100644
--- a/docx/actions/media/MediaPlay.md
+++ b/docx/actions/media/MediaPlay.md
@@ -1,18 +1,21 @@
# 声音播放
播放声音文件
+![MediaPlay](./images/01.png ':size=90%')
+
## 子流程
> 不支持
## 运行参数
-* File:播放的声音文件
+* 媒体
+> 本地声音文件,或者网址。
## 输出
-
+> 无
## 脚本调用
@@ -22,4 +25,10 @@ import simple;
```
-## 示例
\ No newline at end of file
+
+## 资源
+
+示例:https://github.com/shelllet/WinUi/blob/main/media/MediaPlay.simple
+
+
+!> 该动作是同步动作,声音文件播放完毕后返回。
diff --git a/docx/actions/media/PixelPoint.md b/docx/actions/media/PixelPoint.md
new file mode 100644
index 0000000..fb0c1a3
--- /dev/null
+++ b/docx/actions/media/PixelPoint.md
@@ -0,0 +1,34 @@
+# 屏幕取色
+这个动作检索指定坐标处的像素的红色,绿色,蓝色(RGB)颜色值。
+
+![PixelPoint](./images/01.png ':size=90%')
+
+## 子流程
+> 不支持
+
+
+## 运行参数
+
+* 数据源
+> 图像或者窗口,默认从当前屏幕获取颜色
+
+* 坐标
+> 要获取颜色的位置
+
+## 输出
+
+> 颜色,参考:[Color](./types/Color.md)
+
+
+## 脚本调用
+
+```python
+import simple;
+
+```
+
+
+## 资源
+
+示例:https://github.com/shelllet/WinUi/blob/main/media/CaptureWindow.simple
+
diff --git a/docx/actions/media/PlayRecord.md b/docx/actions/media/PlayRecord.md
index 4fb08b5..b9b7ee6 100644
--- a/docx/actions/media/PlayRecord.md
+++ b/docx/actions/media/PlayRecord.md
@@ -1,6 +1,7 @@
-# 播放录制
-用于重放录制的键盘/鼠标宏。
+# 键盘/鼠标宏重放
+用于重放录制的键盘/鼠标宏。录制方法参考:[鼠标/键盘宏录制](.\intro\workflow\macro_record.md)
+![PlayRecord](./images/01.png ':size=90%')
## 子流程
> 不支持
@@ -8,14 +9,15 @@
## 运行参数
-* [record](./types/Number.md)
- > 录制的键盘鼠标宏, 脚本中需要使用相应的ID.
+* 宏
+ > 录制的键盘鼠标宏。
+* 半径
+> 修正半径, 为避免每次重放使用相同的坐标位置,可以设置一个半径,以原坐标为原点,生成一个随机位置移动鼠标。
## 输出
-
-
+> 无
## 脚本调用
@@ -24,4 +26,11 @@ import simple;
```
-## 示例
\ No newline at end of file
+
+## 资源
+
+示例:https://github.com/shelllet/WinUi/blob/main/media/PlayRecord.simple
+
+
+
+!> 该动作是同步动作,声音文件播放完毕后返回。
diff --git a/docx/actions/media/VideoFrame.md b/docx/actions/media/VideoFrame.md
index 9b69a0a..e7103eb 100644
--- a/docx/actions/media/VideoFrame.md
+++ b/docx/actions/media/VideoFrame.md
@@ -1,16 +1,19 @@
# 相机图像
-这个动作可以获取相机的当前图像帧。
+获取相机的当前图像帧。
+
+![VideoFrame](./images/01.png ':size=90%')
## 子流程
> 不支持
## 运行参数
-
+* 相机
+> 打开的相机
## 输出
-> 图像[Image](./types/Image.md)
+> 图像,参考:[Image](./types/Image.md)
## 脚本调用
@@ -20,4 +23,8 @@ import simple;
```
-## 资源
\ No newline at end of file
+
+## 资源
+
+示例:https://github.com/shelllet/WinUi/blob/main/media/VideoFrame.simple
+
diff --git a/docx/actions/media/images/01.png b/docx/actions/media/images/01.png
new file mode 100644
index 0000000..b83413c
Binary files /dev/null and b/docx/actions/media/images/01.png differ
diff --git a/docx/actions/media/images/02.png b/docx/actions/media/images/02.png
new file mode 100644
index 0000000..25092c6
Binary files /dev/null and b/docx/actions/media/images/02.png differ
diff --git a/docx/actions/media/images/03.png b/docx/actions/media/images/03.png
new file mode 100644
index 0000000..aee3b35
Binary files /dev/null and b/docx/actions/media/images/03.png differ
diff --git a/docx/actions/mouse/ListenMouse.md b/docx/actions/mouse/ListenMouse.md
index eae597c..bdb4e82 100644
--- a/docx/actions/mouse/ListenMouse.md
+++ b/docx/actions/mouse/ListenMouse.md
@@ -9,8 +9,8 @@
## 运行参数
-* [msg](./enums/MouseMessage.md)
- > 鼠标消息
+* 鼠标键
+ > 鼠标消息,参考:[MouseMessage](./enums/MouseMessage.md)。
## 输出
@@ -36,4 +36,5 @@ r.run(cbk)
-
\ No newline at end of file
+
+
diff --git a/docx/actions/system/CloseHandle.md b/docx/actions/system/CloseHandle.md
index 7251855..6322c50 100644
--- a/docx/actions/system/CloseHandle.md
+++ b/docx/actions/system/CloseHandle.md
@@ -15,7 +15,7 @@
* [exeFile](./types/Path.md):应用程序,为避免同名程序文件,这个值应为程序路径
* [type](./enums/HandleType.md):句柄类型
-* [name](./types/String.md):句柄名称。支持 [通配符匹配](./intro/workflow/wildcard.md) 匹配
+* [name](./types/String.md):句柄名称。支持 [通配符匹配](./introduction/workflow/wildcard.md) 匹配
## 输出
diff --git a/docx/actions/system/ExistProcess.md b/docx/actions/system/ExistProcess.md
index 950975d..6e1e045 100644
--- a/docx/actions/system/ExistProcess.md
+++ b/docx/actions/system/ExistProcess.md
@@ -12,7 +12,7 @@
## 运行参数
-* [app](./types/Path.md):进程路径,支持 [*Wildcard*](./intro/workflow/wildcard.md) 匹配
+* [app](./types/Path.md):进程路径,支持 [*Wildcard*](./introduction/workflow/wildcard.md) 匹配
## 输出
diff --git a/docx/actions/system/KillProcess.md b/docx/actions/system/KillProcess.md
index c72837f..6f94046 100644
--- a/docx/actions/system/KillProcess.md
+++ b/docx/actions/system/KillProcess.md
@@ -12,7 +12,7 @@
## 运行参数
-* [app](./types/Path.md):进程路径,支持 [*Wildcard*](./intro/workflow/wildcard.md) 匹配
+* [app](./types/Path.md):进程路径,支持 [*Wildcard*](./introduction/workflow/wildcard.md) 匹配
## 输出
diff --git a/docx/actions/web/WebGetElement.md b/docx/actions/web/WebGetElement.md
index 4ad28bc..45cdcca 100644
--- a/docx/actions/web/WebGetElement.md
+++ b/docx/actions/web/WebGetElement.md
@@ -10,7 +10,7 @@
## 运行参数
* Driver: 浏览器对象,即 *WebOpen* 动作的返回值。
-* By: 查找元素的方法, 参考 [定位策略](./intro/webdriver/locators.md)
+* By: 查找元素的方法, 参考 [定位策略](./introduction/webdriver/locators.md)
## 输出
diff --git a/docx/actions/web/WebWaitClickable.md b/docx/actions/web/WebWaitClickable.md
index a8d701a..7ceaf12 100644
--- a/docx/actions/web/WebWaitClickable.md
+++ b/docx/actions/web/WebWaitClickable.md
@@ -9,7 +9,7 @@
* Driver:浏览器对象
* Timeout:超时时间,默认 *60* 秒。
* Element:元素值, 由 *By* 值确定。字符串类型 [`String`](./types/String.md)
-* By:定位策略,参考:[web locators](./intro/webdriver/locators.md)
+* By:定位策略,参考:[web locators](./introduction/webdriver/locators.md)
## 输出
diff --git a/docx/actions/web/WebWaitFrameAvailable.md b/docx/actions/web/WebWaitFrameAvailable.md
index 8d7b4d1..de60cff 100644
--- a/docx/actions/web/WebWaitFrameAvailable.md
+++ b/docx/actions/web/WebWaitFrameAvailable.md
@@ -9,7 +9,7 @@
* Driver:浏览器对象
* Timeout:超时时间,默认 *60* 秒。
* Element:元素值, 由 *By* 值确定。字符串类型 [`String`](./types/String.md)
-* By:定位策略,参考:[web locators](./intro/webdriver/locators.md)
+* By:定位策略,参考:[web locators](./introduction/webdriver/locators.md)
## 输出
diff --git a/docx/actions/web/WebWaitPresence.md b/docx/actions/web/WebWaitPresence.md
index beb59f6..c5e974d 100644
--- a/docx/actions/web/WebWaitPresence.md
+++ b/docx/actions/web/WebWaitPresence.md
@@ -9,7 +9,7 @@
* Driver:浏览器对象
* Timeout:超时时间,默认 *60* 秒。
* Element:元素值, 由 *By* 值确定。
-* By:定位策略,参考:[web locators](./intro/webdriver/locators.md)
+* By:定位策略,参考:[web locators](./introduction/webdriver/locators.md)
* Mode:模型,唯一/所有,比如 *By* 根据 *ID* 定位, 这里的 *Mode* 就是 *One* ;比如 *By* 根据 *CLASS_NAME* 定位元素,就可以使用 *ALl*。
diff --git a/docx/actions/web/WebWaitVisibilityByLocator.md b/docx/actions/web/WebWaitVisibilityByLocator.md
index b1d4487..9716b07 100644
--- a/docx/actions/web/WebWaitVisibilityByLocator.md
+++ b/docx/actions/web/WebWaitVisibilityByLocator.md
@@ -1,5 +1,5 @@
# 等待*可见(定位器)
-通过[定位策略](./intro/webdriver/locators.md),检查已知存在于页面 *DOM* 上的元素是否可见,可见性意味着元素不仅被显示而且高度和宽度都大于 `0`
+通过[定位策略](./introduction/webdriver/locators.md),检查已知存在于页面 *DOM* 上的元素是否可见,可见性意味着元素不仅被显示而且高度和宽度都大于 `0`
## 子流程
> 不支持
@@ -9,7 +9,7 @@
* Driver:浏览器对象
* Timeout:超时时间,默认 `60` 秒。
* Element:*Web*元素,根据 *By*的选择会有所不同。
-* By: [定位策略](./intro/webdriver/locators.md)
+* By: [定位策略](./introduction/webdriver/locators.md)
* Visibility:可见性:*显示* `Visible`,和 *隐藏* `Invisible`
* Mode:模式:*一个* `One`,*Any* : `任意` 和 *所有* `All`, 当 *Visibility* 选择 `Invisible` 时,忽略此参数
diff --git a/docx/actions/window/ForegroundWindow.md b/docx/actions/window/ForegroundWindow.md
index 45da2c8..1cf6037 100644
--- a/docx/actions/window/ForegroundWindow.md
+++ b/docx/actions/window/ForegroundWindow.md
@@ -32,4 +32,4 @@ import simple;
-!> 不无前置最小化的窗口
\ No newline at end of file
+!> 无法前置最小化的窗口
\ No newline at end of file
diff --git a/docx/enums/KnownWindow.md b/docx/enums/KnownWindow.md
index 76d7f85..265f6ae 100644
--- a/docx/enums/KnownWindow.md
+++ b/docx/enums/KnownWindow.md
@@ -3,4 +3,6 @@
* Desktop
> 桌面
* Forground
- > 前置窗口。
\ No newline at end of file
+ > 前置窗口, 就是系统将创建指定窗口的线程置于前台并激活该窗口。键盘输入被定向到窗口,并且为用户改变各种视觉提示。系统为创建前台窗口的线程分配比其他线程稍高的优先级。
+* TopMost
+> 置顶窗口
\ No newline at end of file
diff --git a/docx/index.html b/docx/index.html
index ee31a81..57e6ddd 100644
--- a/docx/index.html
+++ b/docx/index.html
@@ -9,6 +9,9 @@
+
+
+
@@ -52,6 +55,16 @@
},
]
}
+
+ const gitalk = new Gitalk({
+ clientID: '1950547cecdacae2a71a',
+ clientSecret: 'ecada96501418c89375751dc8e412af679db4285',
+ repo: 'winui',
+ owner: 'shelllet',
+ admin: ['shelllet'],
+ distractionFreeMode: false
+ })
+
@@ -60,6 +73,7 @@
+