diff --git a/.github/workflows/static.yml b/.github/workflows/static.yml
index c785ad1..af6cfae 100644
--- a/.github/workflows/static.yml
+++ b/.github/workflows/static.yml
@@ -45,6 +45,9 @@ jobs:
mkdir -p /var/www
cp -Rf ./docx/* /var/www
- curl -L -O -J --create-dirs --output-dir /var/www/_media/simple/ https://api.winui.net/simple/v3/download
+ if ! [-f /var/www/_media/winui++${{ vars.VERSION }}-setup.x64.exe]; then
+ curl -L --create-dirs -o winui++${{ vars.VERSION }}-setup.x64.exe --output-dir /var/www/_media https://winui.net/simple/v3/download
+ fi
sudo chown -R caddy:caddy /var/www/_media
+ shell: bash
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 3478d50..2fe6d5a 100644
--- a/docx/CHANGELOG.md
+++ b/docx/CHANGELOG.md
@@ -1,4 +1,25 @@
-# [0.30](https://github.com/shelllet/winui/compare/main...dev) (2023-xx-xx)
+# [0.31](https://github.com/shelllet/winui/compare/main...dev) (2023-12-xx)
+
+### Changed:
+
+1. *工作线程* 动作支持选择是否立即运行。
+2. *监听鼠标* 动作支持鼠标侧键。
+3. *For*(循环)动作名称变更为 *Iterate*(迭代)动作,功能不变。
+4. *IterParam*(迭代参数)动作名称变更为 *Param*(参数)动作,并支持设置默认参数,功能不变。
+5. 增加 *StandardPath*(标准路径)动作,用来表示系统常用路径。
+5. 增加 *FlashWindow*(闪烁窗口)动作,用来闪烁窗口,定位多个相同名称/类名的窗口。
+6. 优化网络相关动作
+
+### Deprecated:
+
+1. *前置窗口截图* 动作弃用,请使用 [*窗口截图*](./actions/media/CaptureWindow.md) 动作。
+1. *窗口筛选* 动作弃用,请使用 [*EnumWindows*](./actions/window/EnumWindows.md) 动作。
+
+### 备注
+
+1. 下载:...
+
+## [0.30](https://github.com/shelllet/winui/compare/main...dev) (2023-11-10)
### 变更:
@@ -11,7 +32,7 @@
### 备注
-1. 下载:
+1. 下载:https://winui.net/_media/simple/WinUi0.30-setup.x64.exe
## [0.29.1](https://github.com/shelllet/winui/compare/main...dev) (2023-10-15)
diff --git a/docx/README.md b/docx/README.md
index 22fcb4b..8f605a0 100644
--- a/docx/README.md
+++ b/docx/README.md
@@ -1,12 +1,13 @@
# WinUi++
-一个简单的 *RPA* 工具 ,它可以使用图形化的界面,不用编程就可以方便地设计出各种自动化的流程,然后自动执行重复性的手动任务,从而节省了企业的时间、员工工作量,并减少了麻烦。例如可以通过图像识别,并借助鼠标键盘模拟帮你完成各种各样的繁复操作。
+一个简单的 _RPA_ 工具 ,它可以使用图形化的界面,不用编程就可以方便地设计出各种自动化的流程,然后自动执行重复性的手动任务,从而节省了企业的时间、员工工作量,并减少了麻烦。例如可以通过图像识别,并借助鼠标键盘模拟帮你完成各种各样的繁复操作。
-不同于其它大多数*RPA*软件(又大又慢),*WinUi++* 充分考虑了性能和执行效率和流程设计的方便性。 *WinUi++* 小、快而简单。并且界面更美观和现代化。
+不同于其它大多数*RPA*软件(又大又慢),_WinUi++_ 充分考虑了性能和执行效率和流程设计的方便性。 _WinUi++_ 小、快而简单。并且界面更美观和现代化。
-*WinUi++* 绝对不会嵌入任何广告、捆绑任何软件。也不会像国内某大厂一样耍流氓!比如安装的时候,加入各种捆绑,一不小心就装了某家的全家桶。在卸载的时候还要弄个脑筋急转弯,让你怀疑智商,甚至怀疑人生。
+_WinUi++_ 绝对不会嵌入任何广告、捆绑任何软件。也不会像国内某大厂一样耍流氓!比如安装的时候,加入各种捆绑,一不小心就装了某家的全家桶。在卸载的时候还要弄个脑筋急转弯,让你怀疑智商,甚至怀疑人生。
+
+无论是打游戏还是工作当中,_WinUi++_ 都是不可缺少的一款辅助工具。
-无论是打游戏还是工作当中,*WinUi++* 都是不可缺少的一款辅助工具。
### 主要功能
1. 鼠标键盘模拟和录制
@@ -23,24 +24,22 @@
12. 数据统计分析
13. ...
-
#### [截图](https://winui.net/)
-![WinUi++](https://winui.net/intro/images/01.png)
-
-* 开发版文档:https://shelllet.github.io/winui/#/
-
-* 示例流程:https://github.com/shelllet/winui
-* 最新版本下载:[https://winui.net/](https://winui.net/)
+![WinUi++](https://winui.net/introduction/images/01.png)
+- 开发版文档:https://shelllet.github.io/winui/#/
+- 示例流程:https://github.com/shelllet/winui
-* 油管: [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)
+- 最新版本下载:[https://winui.net/](https://winui.net/)
-* 加入 [Discord](https://discord.gg/b4MeYbJrfk) 讨论。
+- 油管: [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) 讨论。
-
-
-
+
diff --git a/docx/_coverpage.md b/docx/_coverpage.md
index 1f3dd59..5742c0c 100644
--- a/docx/_coverpage.md
+++ b/docx/_coverpage.md
@@ -5,6 +5,6 @@
- Right now support down to build 17763 (version 1809/October 2018 Update) of Windows 10.
[微软商店](https://apps.microsoft.com/store/detail/XP9BRHTXN0Z3V7)
-[下载](https://api.winui.net/simple/v3/download)
+[下载](https://api.winui.net/simple/v3/download ':id=simple')
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 9a3a5f1..184e35b 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/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)
@@ -35,7 +35,7 @@
- [状态切换](./actions/async/WorkReset.md)
- [等待事件](./actions/async/WhenEvent.md)
- [异步等待](./actions/async/WorkWait.md)
- - 文件
+ - 文件系统
- [读取文件](./actions/filesystem/FileRead.md)
- [文件写入](./actions/filesystem/FileWrite.md)
- [按行读取](./actions/filesystem/ReadLines.md)
@@ -44,6 +44,7 @@
- [搜索文件](./actions/filesystem/FileQuery.md)
- [遍历文件](./actions/filesystem/DirectoryIterator.md)
- [文件复制](./actions/filesystem/CopyFile.md)
+ - [标准路径](./actions/filesystem/StandardPath.md)
- 键盘
- [发送按键](./actions/keyboard/SendKey.md)
- [发送文本](./actions/keyboard/SendText.md)
@@ -75,6 +76,7 @@
- [窗口位置](./actions/window/WindowXy.md)
- [窗口大小](./actions/window/WindowSize.md)
- [窗口坐标](./actions/window/WindowPoint.md)
+ - [闪烁窗口](./actions/window/FlashWindow.md)
- 图像处理
- [颜色转换](./actions/image/CvtColor.md)
- [裁切图片](./actions/image/CropImage.md)
@@ -110,84 +112,32 @@
- [中文识别](./actions/dnn/TextChinese.md)
- [文本块检测](./actions/dnn/TextDetection.md)
- [二维码识别](./actions/dnn/QRCode.md)
- - 网络
- - [下载](./actions/network/HttpDownload.md)
- - [视频下载](./actions/network/YoutubeDownload.md)
- - [Head](./actions/network/HttpHead.md)
- - [Get](./actions/network/HttpGet.md)
- - [Post](./actions/network/HttpPost.md)
- - [监听](./actions/network/TcpListen.md)
- - [发送](./actions/network/TcpSend.md)
- - [接收](./actions/network/TcpReceive.md)
- - [连接](./actions/network/TcpConnect.md)
- - Web
- - [打开浏览器](./actions/web/WebOpen.md)
- - [查找元素](./actions/web/WebGetElement.md)
- - [点击](./actions/web/WebElementClick.md)
- - [表单提交](./actions/web/WebElementSubmit.md)
- - [清除文本](./actions/web/WebElementClear.md)
- - [选中检查](./actions/web/WebElementIsSelect.md)
- - [发送按键](./actions/web/WebElementSendKey.md)
- - [发送文本](./actions/web/WebElementSendText.md)
- - [获取属性](./actions/web/WebElementAttribute.md)
- - [等待*警告框](./actions/web/WebWaitAlert.md)
- - [等待*元素呈现](./actions/web/WebWaitPresence.md)
- - [等待*框架可切换](./actions/web/WebWaitFrameAvailable.md)
- - [等待*标题](./actions/web/WebWaitTitle.md)
- - [等待*可见](./actions/web/WebWaitVisibilityByElement.md)
- - [等待*可见(定位器)](./actions/web/WebWaitVisibilityByLocator.md)
- - [切换框架](./actions/web/WebSwitchToFrame.md)
- - [框架*设置焦点](./actions/web/WebFocusFrameDefault.md)
- - [元素截图](./actions/web/WebScreenshot.md)
- - [动作链*创建](./actions/web/WebActionChainsCreated.md)
- - [动作链*执行](./actions/web/WebActionChainsPerform.md)
- - [动作链.点击](./actions/web/WebActionClick.md)
- - [动作链.点按](./actions/web/WebActionClickHold.md)
- - [动作链.双击](./actions/web/WebActionDoubleClick.md)
- - [动作链.拖放](./actions/web/WebActionDragDrop.md)
- - [动作链.移动](./actions/web/WebActionMoveTo.md)
- - [动作链.释放](./actions/web/WebActionRelease.md)
- - [动作链.按键](./actions/web/WebActionKeyDown.md)
- - [动作链.释放按键](./actions/web/WebActionKeyUp.md)
- - [动作链.移动(偏移)](./actions/web/WebActionMoveOffset.md)
- - [动作链.发送文本](./actions/web/WebActionSendText.md)
- - [获取 Cookies](./actions/web/WebCookies.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/cloud/BaiduTranslate.md)
- - Xml
+ - 网络
+ - [文件下载](./actions/network/HttpDownload.md)
+ - [视频下载](./actions/network/VideoDownload.md)
+ - [HEAD 请求](./actions/network/HttpHead.md)
+ - [GET 请求](./actions/network/HttpGet.md)
+ - [POST 请求](./actions/network/HttpPost.md)
+ - [网络服务](./actions/network/NetworkListen.md)
+ - [网络发送](./actions/network/NetworkSend.md)
+ - [网络接收](./actions/network/NetworkReceive.md)
+ - [服务连接](./actions/network/NetworkConnect.md)
+ - 统计分析
- [文档](./actions/xml/XmlLoadDocument.md)
- [获取节点](./actions/xml/XmlGetNodeList.md)
- [节点名称](./actions/xml/XmlNodeName.md)
- [元素](./actions/xml/XmlDocumentElement.md)
- [文本替换](./actions/xml/XmlReplaceText.md)
- [保存](./actions/xml/XmlSaveDocument.md)
- - Json
- [读取 Json](./actions/json/ReadJson.md)
- - 安卓
- - [设备列表](./actions/android/AdbDevices.md)
- - [连接](./actions/android/AdbConnect.md)
- - [转发](./actions/android/AdbForward.md)
- - [移除转发](./actions/android/AdbRemoveForward.md)
- - [滑动](./actions/android/AdbSwipe.md)
- - [输入](./actions/android/AdbInput.md)
- - [按键](./actions/android/AdbKey.md)
- - [点击](./actions/android/AdbTap.md)
- - [截图](./actions/android/AdbScreenCap.md)
- - [打开应用](./actions/android/AdbStartApp.md)
- - [安装包](./actions/android/AdbPackages.md)
- - [移动](./actions/android/AdbMove.md)
- - [网卡配置](./actions/android/AdbIfConfig.md)
- - [启动服务](./actions/android/AdbStartServer.md)
- - [终止服务](./actions/android/AdbKillServer.md)
- 逻辑
- - [循环](./actions/control/For.md)
+ - [迭代](./actions/control/Iterate.md)
- [判断](./actions/control/If.md)
- [判空](./actions/control/IsEmpty.md)
- [调用](./actions/control/Invoke.md)
@@ -202,7 +152,7 @@
- [算术运行](./actions/control/ArithmeticCalculate.md)
- [逻辑运算](./actions/control/LogicalOperator.md)
- [关系运算](./actions/control/RelationalOperator.md)
- - [传入参数](./actions/control/InputParam.md)
+ - [参数](./actions/control/Param.md)
- 算法
- [分割字符串](./actions/algorithm/SplitString.md)
- [非零像素点](./actions/algorithm/FindNonZero.md)
@@ -237,6 +187,56 @@
- [颜色](./actions/type/TypeColor.md)
- [模型](./actions/type/ONNXModel.md)
- [相机](./actions/type/Camera.md)
+ - 云
+ - [百度翻译](./actions/cloud/BaiduTranslate.md)
+ - Web
+ - [打开浏览器](./actions/web/WebOpen.md)
+ - [查找元素](./actions/web/WebGetElement.md)
+ - [点击](./actions/web/WebElementClick.md)
+ - [表单提交](./actions/web/WebElementSubmit.md)
+ - [清除文本](./actions/web/WebElementClear.md)
+ - [选中检查](./actions/web/WebElementIsSelect.md)
+ - [发送按键](./actions/web/WebElementSendKey.md)
+ - [发送文本](./actions/web/WebElementSendText.md)
+ - [获取属性](./actions/web/WebElementAttribute.md)
+ - [等待*警告框](./actions/web/WebWaitAlert.md)
+ - [等待*元素呈现](./actions/web/WebWaitPresence.md)
+ - [等待*框架可切换](./actions/web/WebWaitFrameAvailable.md)
+ - [等待*标题](./actions/web/WebWaitTitle.md)
+ - [等待*可见](./actions/web/WebWaitVisibilityByElement.md)
+ - [等待*可见(定位器)](./actions/web/WebWaitVisibilityByLocator.md)
+ - [切换框架](./actions/web/WebSwitchToFrame.md)
+ - [框架*设置焦点](./actions/web/WebFocusFrameDefault.md)
+ - [元素截图](./actions/web/WebScreenshot.md)
+ - [动作链*创建](./actions/web/WebActionChainsCreated.md)
+ - [动作链*执行](./actions/web/WebActionChainsPerform.md)
+ - [动作链.点击](./actions/web/WebActionClick.md)
+ - [动作链.点按](./actions/web/WebActionClickHold.md)
+ - [动作链.双击](./actions/web/WebActionDoubleClick.md)
+ - [动作链.拖放](./actions/web/WebActionDragDrop.md)
+ - [动作链.移动](./actions/web/WebActionMoveTo.md)
+ - [动作链.释放](./actions/web/WebActionRelease.md)
+ - [动作链.按键](./actions/web/WebActionKeyDown.md)
+ - [动作链.释放按键](./actions/web/WebActionKeyUp.md)
+ - [动作链.移动(偏移)](./actions/web/WebActionMoveOffset.md)
+ - [动作链.发送文本](./actions/web/WebActionSendText.md)
+ - [获取 Cookies](./actions/web/WebCookies.md)
+ - 安卓
+ - [设备列表](./actions/android/AdbDevices.md)
+ - [连接](./actions/android/AdbConnect.md)
+ - [转发](./actions/android/AdbForward.md)
+ - [移除转发](./actions/android/AdbRemoveForward.md)
+ - [滑动](./actions/android/AdbSwipe.md)
+ - [输入](./actions/android/AdbInput.md)
+ - [按键](./actions/android/AdbKey.md)
+ - [点击](./actions/android/AdbTap.md)
+ - [截图](./actions/android/AdbScreenCap.md)
+ - [打开应用](./actions/android/AdbStartApp.md)
+ - [安装包](./actions/android/AdbPackages.md)
+ - [移动](./actions/android/AdbMove.md)
+ - [网卡配置](./actions/android/AdbIfConfig.md)
+ - [启动服务](./actions/android/AdbStartServer.md)
+ - [终止服务](./actions/android/AdbKillServer.md)
- 内置类型
- [Boolean](./types/Boolean.md)
- [Number](./types/Number.md)
@@ -260,6 +260,7 @@
- [Timer](./types/Timer.md)
- [Thread](./types/Thread.md)
- [Keyboard](./types/Keyboard.md)
+ - [主机地址](./types/HostAddress.md)
- 枚举类型
- [ThresholdTypes](./enums/ThresholdTypes.md)
- [Directions](./enums/Directions.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/WhenEvent.md b/docx/actions/async/WhenEvent.md
index cb85cf3..aa3829d 100644
--- a/docx/actions/async/WhenEvent.md
+++ b/docx/actions/async/WhenEvent.md
@@ -33,4 +33,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/async/WorkBegin.md b/docx/actions/async/WorkBegin.md
index 88762da..647aa64 100644
--- a/docx/actions/async/WorkBegin.md
+++ b/docx/actions/async/WorkBegin.md
@@ -27,4 +27,4 @@
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/async/WorkExit.md b/docx/actions/async/WorkExit.md
index 9bdb0be..c816fe9 100644
--- a/docx/actions/async/WorkExit.md
+++ b/docx/actions/async/WorkExit.md
@@ -29,4 +29,4 @@
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/async/WorkReset.md b/docx/actions/async/WorkReset.md
index 96faeb4..6cf07f4 100644
--- a/docx/actions/async/WorkReset.md
+++ b/docx/actions/async/WorkReset.md
@@ -30,4 +30,4 @@
-
+
diff --git a/docx/actions/async/WorkTask.md b/docx/actions/async/WorkTask.md
index 2efbde0..e480182 100644
--- a/docx/actions/async/WorkTask.md
+++ b/docx/actions/async/WorkTask.md
@@ -28,4 +28,4 @@
-
+
diff --git a/docx/actions/async/WorkThread.md b/docx/actions/async/WorkThread.md
index b8cf4c6..070f86a 100644
--- a/docx/actions/async/WorkThread.md
+++ b/docx/actions/async/WorkThread.md
@@ -12,6 +12,8 @@
## 运行参数
+* 手动
+> 线程默认状态开始即运行,如果选中此参数,线程一开始则不会执行,需要配合使用其它动作使其运行。
## 输出
@@ -29,4 +31,4 @@
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/async/WorkTimer.md b/docx/actions/async/WorkTimer.md
index 0b4beb3..816904f 100644
--- a/docx/actions/async/WorkTimer.md
+++ b/docx/actions/async/WorkTimer.md
@@ -35,4 +35,4 @@
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/control/InputParam.md b/docx/actions/control/InputParam.md
deleted file mode 100644
index 7a5e163..0000000
--- a/docx/actions/control/InputParam.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# 传入参数
-通常做为子动作,其值由相应的父动作传入。通常列表都会支持子动作,列表的每个元素都会传递给该动作。
-
-![action](./images/2022-11-17_184608.png ':size=90%')
-
-## 子流程
-
-> 不支持
-
-## 运行参数
-
-
-
-
-## 输出
-
-> 无
-
-
-## 脚本调用
-
-```python
-import simple
-
-
-```
-
-## 示例
-
diff --git a/docx/actions/control/For.md b/docx/actions/control/Iterate.md
similarity index 65%
rename from docx/actions/control/For.md
rename to docx/actions/control/Iterate.md
index 9fbbbf8..9719aad 100644
--- a/docx/actions/control/For.md
+++ b/docx/actions/control/Iterate.md
@@ -1,5 +1,5 @@
-# 循环
-循环,主要用来迭代容器
+# 迭代
+用来迭代相应的列表数据,遍历列表的每一个元素,也可称为*循环*。
![action](./images/2022-11-17_184608.png ':size=90%')
diff --git a/docx/actions/control/Param.md b/docx/actions/control/Param.md
new file mode 100644
index 0000000..b97d47d
--- /dev/null
+++ b/docx/actions/control/Param.md
@@ -0,0 +1,29 @@
+# 参数
+用于获取由父动作传入子动作的数据。例如,在迭代动作的子动作中添加该动作,便可获取被迭代的每个元素值。
+
+![Param](./images/2022-11-17_184608.png ':size=90%')
+
+## 子流程
+
+> 不支持
+
+## 运行参数
+
+
+
+
+## 输出
+
+> 无
+
+
+## 脚本调用
+
+```python
+import simple
+
+
+```
+
+## 示例
+
diff --git a/docx/actions/detection/BlobDetect.md b/docx/actions/detection/BlobDetect.md
index 7a17e24..804273f 100644
--- a/docx/actions/detection/BlobDetect.md
+++ b/docx/actions/detection/BlobDetect.md
@@ -48,4 +48,9 @@ import simple;
-
\ No newline at end of file
+
+
+## 版本变化
+
+* 0.31
+> 图像参数支持使用*窗口*类型。
\ No newline at end of file
diff --git a/docx/actions/detection/EllipseDetection.md b/docx/actions/detection/EllipseDetection.md
index bdb6e77..2cb0b08 100644
--- a/docx/actions/detection/EllipseDetection.md
+++ b/docx/actions/detection/EllipseDetection.md
@@ -37,4 +37,9 @@ import simple;
-
\ No newline at end of file
+
+
+## 版本变化
+
+* 0.31
+> 图像参数支持使用*窗口*类型。
\ No newline at end of file
diff --git a/docx/actions/detection/FeatureDetect.md b/docx/actions/detection/FeatureDetect.md
index 8898ad0..b9d81fe 100644
--- a/docx/actions/detection/FeatureDetect.md
+++ b/docx/actions/detection/FeatureDetect.md
@@ -39,7 +39,13 @@ import simple;
-
+
-!> 该动作会先将源图像和模板图像转换成灰度图像,再进行匹配。
\ No newline at end of file
+!> 该动作会先将源图像和模板图像转换成灰度图像,再进行匹配。
+
+
+## 版本变化
+
+* 0.31
+> 图像参数支持使用*窗口*类型。
\ No newline at end of file
diff --git a/docx/actions/detection/FindContours.md b/docx/actions/detection/FindContours.md
index b4f5ce0..3b3f81a 100644
--- a/docx/actions/detection/FindContours.md
+++ b/docx/actions/detection/FindContours.md
@@ -37,4 +37,10 @@ import simple;
-
+
+
+
+## 版本变化
+
+* 0.31
+> 图像参数支持使用*窗口*类型。
\ No newline at end of file
diff --git a/docx/actions/detection/LineDetection.md b/docx/actions/detection/LineDetection.md
index b270001..9b368af 100644
--- a/docx/actions/detection/LineDetection.md
+++ b/docx/actions/detection/LineDetection.md
@@ -39,4 +39,10 @@ import simple;
-
\ No newline at end of file
+
+
+
+## 版本变化
+
+* 0.31
+> 图像参数支持使用*窗口*类型。
\ No newline at end of file
diff --git a/docx/actions/detection/MatchShapes.md b/docx/actions/detection/MatchShapes.md
index 056cf61..98af517 100644
--- a/docx/actions/detection/MatchShapes.md
+++ b/docx/actions/detection/MatchShapes.md
@@ -40,4 +40,9 @@ import simple;
-
\ No newline at end of file
+
+
+## 版本变化
+
+* 0.31
+> 图像参数支持使用*窗口*类型。
\ No newline at end of file
diff --git a/docx/actions/detection/MatchTemplate.md b/docx/actions/detection/MatchTemplate.md
index db50c52..6270fc7 100644
--- a/docx/actions/detection/MatchTemplate.md
+++ b/docx/actions/detection/MatchTemplate.md
@@ -39,4 +39,9 @@ import simple;
-
+
+
+## 版本变化
+
+* 0.31
+> 图像参数支持使用*窗口*类型。
\ No newline at end of file
diff --git a/docx/actions/detection/ShapeDetection.md b/docx/actions/detection/ShapeDetection.md
index 90d3d3c..468915f 100644
--- a/docx/actions/detection/ShapeDetection.md
+++ b/docx/actions/detection/ShapeDetection.md
@@ -40,4 +40,9 @@ import simple;
-
\ No newline at end of file
+
+
+## 版本变化
+
+* 0.31
+> 图像参数支持使用*窗口*类型。
\ No newline at end of file
diff --git a/docx/actions/dnn/ImageClassification.md b/docx/actions/dnn/ImageClassification.md
index 6950622..4e0247f 100644
--- a/docx/actions/dnn/ImageClassification.md
+++ b/docx/actions/dnn/ImageClassification.md
@@ -36,4 +36,9 @@ import simple;
示例 https://github.com/shelllet/WinUi/blob/main/dnn/ImageClassification.simple
-!> ONNX Model Zoo: https://github.com/onnx/models
\ No newline at end of file
+
+
+
+
+
+!> ONNX Model Zoo: https://github.com/onnx/models
diff --git a/docx/actions/dnn/ObjectDetection.md b/docx/actions/dnn/ObjectDetection.md
index fb0121a..537715f 100644
--- a/docx/actions/dnn/ObjectDetection.md
+++ b/docx/actions/dnn/ObjectDetection.md
@@ -21,7 +21,7 @@
* 框架
> 目前仅支持 *Yolo5* 架构的模型
-
+
## 输出
> 检测到的图像位置,参考:[DetectionResults](./types/DetectionResult.md)
@@ -37,3 +37,8 @@ import simple;
### 资源
示例 https://github.com/shelllet/WinUi/blob/main/dnn/ObjectDetection.simple
+
+
+
+
+
\ No newline at end of file
diff --git a/docx/actions/dnn/QRCode.md b/docx/actions/dnn/QRCode.md
index 876d47f..7debd2b 100644
--- a/docx/actions/dnn/QRCode.md
+++ b/docx/actions/dnn/QRCode.md
@@ -26,3 +26,8 @@ import simple;
### 资源
示例 https://github.com/shelllet/WinUi/blob/main/dnn/QRCode.simple
+
+
+
+
+
\ No newline at end of file
diff --git a/docx/actions/dnn/TextChinese.md b/docx/actions/dnn/TextChinese.md
index 09e4c90..e079813 100644
--- a/docx/actions/dnn/TextChinese.md
+++ b/docx/actions/dnn/TextChinese.md
@@ -36,3 +36,7 @@ import simple;
### 资源
示例 https://github.com/shelllet/WinUi/blob/main/dnn/TextChinese.simple
+
+
+
+
\ No newline at end of file
diff --git a/docx/actions/dnn/TextDetection.md b/docx/actions/dnn/TextDetection.md
index 01261e2..8f2592a 100644
--- a/docx/actions/dnn/TextDetection.md
+++ b/docx/actions/dnn/TextDetection.md
@@ -29,4 +29,8 @@ import simple;
示例 https://github.com/shelllet/WinUi/blob/main/dnn/TextDetection.simple
-!> 文字检测模型训练:https://github.com/PaddlePaddle/PaddleOCR/blob/release/2.6/doc/doc_ch/detection.md
\ No newline at end of file
+
+
+
+
+!> 文字检测模型训练:https://github.com/PaddlePaddle/PaddleOCR/blob/release/2.6/doc/doc_ch/detection.md
diff --git a/docx/actions/draw/DrawRect.md b/docx/actions/draw/DrawRect.md
index 8c20377..36b9059 100644
--- a/docx/actions/draw/DrawRect.md
+++ b/docx/actions/draw/DrawRect.md
@@ -38,4 +38,4 @@ import simple;
-
+
diff --git a/docx/actions/draw/FillColor.md b/docx/actions/draw/FillColor.md
index c60fcdd..8de63dc 100644
--- a/docx/actions/draw/FillColor.md
+++ b/docx/actions/draw/FillColor.md
@@ -37,4 +37,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/filesystem/CopyFile.md b/docx/actions/filesystem/CopyFile.md
index bbd0e38..7a73e03 100644
--- a/docx/actions/filesystem/CopyFile.md
+++ b/docx/actions/filesystem/CopyFile.md
@@ -41,6 +41,6 @@ r.run()
-
+
!> 不可复制文件夹
\ No newline at end of file
diff --git a/docx/actions/filesystem/DirectoryIterator.md b/docx/actions/filesystem/DirectoryIterator.md
index 0b9ff0a..5b93ab5 100644
--- a/docx/actions/filesystem/DirectoryIterator.md
+++ b/docx/actions/filesystem/DirectoryIterator.md
@@ -42,4 +42,4 @@ r.run(cbk)
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/filesystem/FileQuery.md b/docx/actions/filesystem/FileQuery.md
index 6fe7792..62e5e36 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)
> 匹配行为
@@ -38,4 +38,4 @@ r.run()
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/filesystem/FileRead.md b/docx/actions/filesystem/FileRead.md
index b940c55..effba84 100644
--- a/docx/actions/filesystem/FileRead.md
+++ b/docx/actions/filesystem/FileRead.md
@@ -34,4 +34,4 @@ import simple
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/filesystem/FileWrite.md b/docx/actions/filesystem/FileWrite.md
index 004b24c..c8824e0 100644
--- a/docx/actions/filesystem/FileWrite.md
+++ b/docx/actions/filesystem/FileWrite.md
@@ -34,4 +34,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/filesystem/ImageLoad.md b/docx/actions/filesystem/ImageLoad.md
index 1b344ca..e2e1283 100644
--- a/docx/actions/filesystem/ImageLoad.md
+++ b/docx/actions/filesystem/ImageLoad.md
@@ -33,4 +33,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/filesystem/ImageSave.md b/docx/actions/filesystem/ImageSave.md
index 09485a7..a96ca43 100644
--- a/docx/actions/filesystem/ImageSave.md
+++ b/docx/actions/filesystem/ImageSave.md
@@ -35,4 +35,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/filesystem/ReadLines.md b/docx/actions/filesystem/ReadLines.md
index abf2aa2..2b25fca 100644
--- a/docx/actions/filesystem/ReadLines.md
+++ b/docx/actions/filesystem/ReadLines.md
@@ -43,4 +43,4 @@ r.run(cbk)
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/filesystem/StandardPath.md b/docx/actions/filesystem/StandardPath.md
new file mode 100644
index 0000000..40b3689
--- /dev/null
+++ b/docx/actions/filesystem/StandardPath.md
@@ -0,0 +1,26 @@
+# 标准路径
+此操作包含在本地文件系统上查询标准路径位置的功能,例如特定于用户目录或系统范围的配置目录等常见任务。
+
+## 子流程
+> 不支持
+
+
+## 运行参数
+
+* 类型
+
+> 参考:[KnownFolder](../enums/KnownFolder.md)
+
+## 输出
+
+> 路径,参考:[Path](../types/Path.md)。
+
+
+## 脚本调用
+
+```python
+import simple;
+
+```
+
+## 资源
\ No newline at end of file
diff --git a/docx/actions/image/AdaptiveThreshold.md b/docx/actions/image/AdaptiveThreshold.md
index bf21340..cc96ac0 100644
--- a/docx/actions/image/AdaptiveThreshold.md
+++ b/docx/actions/image/AdaptiveThreshold.md
@@ -45,4 +45,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/image/CenterCropImage.md b/docx/actions/image/CenterCropImage.md
index 2f2e651..ea24594 100644
--- a/docx/actions/image/CenterCropImage.md
+++ b/docx/actions/image/CenterCropImage.md
@@ -33,4 +33,4 @@ import simple;
-
+
diff --git a/docx/actions/image/CropImage.md b/docx/actions/image/CropImage.md
index 9b88400..de6321e 100644
--- a/docx/actions/image/CropImage.md
+++ b/docx/actions/image/CropImage.md
@@ -32,4 +32,4 @@ import simple;
-
+
diff --git a/docx/actions/image/CvtColor.md b/docx/actions/image/CvtColor.md
index 4346943..9655fa5 100644
--- a/docx/actions/image/CvtColor.md
+++ b/docx/actions/image/CvtColor.md
@@ -33,4 +33,4 @@ import simple;
-
+
diff --git a/docx/actions/image/ImageBlur.md b/docx/actions/image/ImageBlur.md
index 7ed74c8..b67546b 100644
--- a/docx/actions/image/ImageBlur.md
+++ b/docx/actions/image/ImageBlur.md
@@ -44,4 +44,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/image/ImageCanny.md b/docx/actions/image/ImageCanny.md
index 6077d6f..6149111 100644
--- a/docx/actions/image/ImageCanny.md
+++ b/docx/actions/image/ImageCanny.md
@@ -34,4 +34,4 @@ import simple;
-
+
diff --git a/docx/actions/image/ImageInRange.md b/docx/actions/image/ImageInRange.md
index 6b7746c..a4b0441 100644
--- a/docx/actions/image/ImageInRange.md
+++ b/docx/actions/image/ImageInRange.md
@@ -43,4 +43,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/image/ImageMarkROI.md b/docx/actions/image/ImageMarkROI.md
index d2cc97b..6dff4c2 100644
--- a/docx/actions/image/ImageMarkROI.md
+++ b/docx/actions/image/ImageMarkROI.md
@@ -37,4 +37,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/image/ImageMarkRelativeROI.md b/docx/actions/image/ImageMarkRelativeROI.md
index 6ffe17c..35d799d 100644
--- a/docx/actions/image/ImageMarkRelativeROI.md
+++ b/docx/actions/image/ImageMarkRelativeROI.md
@@ -45,4 +45,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/image/ImageMorphological.md b/docx/actions/image/ImageMorphological.md
index b8fd7cd..f0b6e80 100644
--- a/docx/actions/image/ImageMorphological.md
+++ b/docx/actions/image/ImageMorphological.md
@@ -52,4 +52,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/image/ImageThreshold.md b/docx/actions/image/ImageThreshold.md
index b78d767..a7754f6 100644
--- a/docx/actions/image/ImageThreshold.md
+++ b/docx/actions/image/ImageThreshold.md
@@ -42,6 +42,6 @@ import simple;
-
+
diff --git a/docx/actions/image/ResizeImage.md b/docx/actions/image/ResizeImage.md
index aa9ef85..6d75264 100644
--- a/docx/actions/image/ResizeImage.md
+++ b/docx/actions/image/ResizeImage.md
@@ -33,4 +33,4 @@ import simple;
-
+
diff --git a/docx/actions/keyboard/ListenKeyboard.md b/docx/actions/keyboard/ListenKeyboard.md
index 69601db..5406a7a 100644
--- a/docx/actions/keyboard/ListenKeyboard.md
+++ b/docx/actions/keyboard/ListenKeyboard.md
@@ -32,6 +32,6 @@ import simple;
-
+
!> 该动作属于异步动作
\ No newline at end of file
diff --git a/docx/actions/keyboard/PressAndReleaseKey.md b/docx/actions/keyboard/PressAndReleaseKey.md
index 83b8438..46b3a4e 100644
--- a/docx/actions/keyboard/PressAndReleaseKey.md
+++ b/docx/actions/keyboard/PressAndReleaseKey.md
@@ -34,4 +34,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/keyboard/PressKey.md b/docx/actions/keyboard/PressKey.md
index b1a3939..3c8c8b6 100644
--- a/docx/actions/keyboard/PressKey.md
+++ b/docx/actions/keyboard/PressKey.md
@@ -35,4 +35,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/keyboard/ReleaseKey.md b/docx/actions/keyboard/ReleaseKey.md
index 0acc2a8..64f0964 100644
--- a/docx/actions/keyboard/ReleaseKey.md
+++ b/docx/actions/keyboard/ReleaseKey.md
@@ -34,4 +34,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/keyboard/SendKey.md b/docx/actions/keyboard/SendKey.md
index 5979eeb..a0c7928 100644
--- a/docx/actions/keyboard/SendKey.md
+++ b/docx/actions/keyboard/SendKey.md
@@ -4,7 +4,7 @@
![SendKey](./images/04.png ':size=90%')
## 权限
-> 据 *UIC* 规则,不能向高权限的用户界面发送按键,例如:普通用户启动的 *WinUi++*, 无法向以管理员方式启动的应用界面发送按键。
+> 据 *UIC* 规则,不能向高权限的用户界面发送按键,例如:普通用户启动的 *WinUi++*, 无法向以管理员方式启动的应用程序窗口发送按键。
## 子流程
> 不支持
@@ -12,27 +12,28 @@
## 运行参数
+* 窗口
+> 需要激活的窗口,默认当前激活的窗口。
* 按键
+> 发送的键盘按键。
* 延迟
> 发送完按键之后所等待的时间,单位:秒
## 输出
-> 无
+> 发送的键盘按键, 参考:
-## 脚本调用
-> 参考 [Keyboard](./types/Keyboard.md)
-
-```python
-import simple;
-
-```
-
## 资源
* 流程:https://github.com/shelllet/WinUi/blob/main/keyboard/SendKey.simple
-
\ No newline at end of file
+
+
+
+## 版本变化
+
+* 0.31
+> 增加 *窗口* 运行参数。
\ No newline at end of file
diff --git a/docx/actions/keyboard/SendText.md b/docx/actions/keyboard/SendText.md
index d7dbc4d..f174de4 100644
--- a/docx/actions/keyboard/SendText.md
+++ b/docx/actions/keyboard/SendText.md
@@ -34,4 +34,4 @@ import simple;
-
\ No newline at end of file
+
\ 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..e17356a 100644
--- a/docx/actions/media/MediaPlay.md
+++ b/docx/actions/media/MediaPlay.md
@@ -1,18 +1,21 @@
# 声音播放
播放声音文件
+![MediaPlay](./images/03.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..22207e9 100644
--- a/docx/actions/media/PlayRecord.md
+++ b/docx/actions/media/PlayRecord.md
@@ -1,6 +1,7 @@
-# 播放录制
-用于重放录制的键盘/鼠标宏。
+# 键盘/鼠标宏重放
+用于重放录制的键盘/鼠标宏。录制方法参考:[鼠标/键盘宏录制](.\intro\workflow\Record.md)。
+![PlayRecord](./images/04.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..737993c 100644
--- a/docx/actions/media/VideoFrame.md
+++ b/docx/actions/media/VideoFrame.md
@@ -1,16 +1,19 @@
# 相机图像
-这个动作可以获取相机的当前图像帧。
+获取相机的当前图像帧。
+
+![VideoFrame](./images/05.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/media/images/04.png b/docx/actions/media/images/04.png
new file mode 100644
index 0000000..9e19e50
Binary files /dev/null and b/docx/actions/media/images/04.png differ
diff --git a/docx/actions/media/images/05.png b/docx/actions/media/images/05.png
new file mode 100644
index 0000000..2df6d9e
Binary files /dev/null and b/docx/actions/media/images/05.png differ
diff --git a/docx/actions/method/SubString.md b/docx/actions/method/SubString.md
new file mode 100644
index 0000000..faab5d2
--- /dev/null
+++ b/docx/actions/method/SubString.md
@@ -0,0 +1,32 @@
+# 字符串提取
+根据特定的方法,可以获取部分字符串。
+
+## 子流程
+> 不支持
+
+
+## 运行参数
+
+* 数据
+
+> 字符串
+
+* 位置
+> 起始位置,如果是 *正值* 从左边开始,如果是 *负值*,从右边开始。
+
+* 长度
+> 提取的长度。
+
+## 输出
+
+> 部分字符串,参考:[String](../types/String.md)。
+
+
+## 脚本调用
+
+```python
+import simple;
+
+```
+
+## 资源
\ No newline at end of file
diff --git a/docx/actions/mouse/Click.md b/docx/actions/mouse/Click.md
index 04e0f49..b0313b5 100644
--- a/docx/actions/mouse/Click.md
+++ b/docx/actions/mouse/Click.md
@@ -37,4 +37,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/mouse/DoubleClick.md b/docx/actions/mouse/DoubleClick.md
index 052cba1..d27b32d 100644
--- a/docx/actions/mouse/DoubleClick.md
+++ b/docx/actions/mouse/DoubleClick.md
@@ -35,4 +35,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/mouse/DragPointer.md b/docx/actions/mouse/DragPointer.md
index 355447c..a54eeed 100644
--- a/docx/actions/mouse/DragPointer.md
+++ b/docx/actions/mouse/DragPointer.md
@@ -32,4 +32,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/mouse/ListenMouse.md b/docx/actions/mouse/ListenMouse.md
index eae597c..510f021 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/mouse/MoveClick.md b/docx/actions/mouse/MoveClick.md
index e76470a..fa721fb 100644
--- a/docx/actions/mouse/MoveClick.md
+++ b/docx/actions/mouse/MoveClick.md
@@ -36,4 +36,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/mouse/MoveDoubleClick.md b/docx/actions/mouse/MoveDoubleClick.md
index 245b6fa..e2c8dc3 100644
--- a/docx/actions/mouse/MoveDoubleClick.md
+++ b/docx/actions/mouse/MoveDoubleClick.md
@@ -38,4 +38,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/mouse/MoveOffset.md b/docx/actions/mouse/MoveOffset.md
index 29c5d95..f14d2cb 100644
--- a/docx/actions/mouse/MoveOffset.md
+++ b/docx/actions/mouse/MoveOffset.md
@@ -33,4 +33,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/mouse/MovePointer.md b/docx/actions/mouse/MovePointer.md
index 6f52da2..8ba241d 100644
--- a/docx/actions/mouse/MovePointer.md
+++ b/docx/actions/mouse/MovePointer.md
@@ -35,4 +35,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/mouse/RightClick.md b/docx/actions/mouse/RightClick.md
index 30ebffc..c13b811 100644
--- a/docx/actions/mouse/RightClick.md
+++ b/docx/actions/mouse/RightClick.md
@@ -33,4 +33,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/network/HttpDownload.md b/docx/actions/network/HttpDownload.md
index f8ee2cd..6bc59ab 100644
--- a/docx/actions/network/HttpDownload.md
+++ b/docx/actions/network/HttpDownload.md
@@ -1,32 +1,28 @@
-# 下载
-此动作通过 *HTTP* 协议下载网络文件。
+# 文件下载
+通过 *http/https* 协议下载网络文件。
-![action](./images/2022-11-27_144417.png ':size=90%')
+![HttpDownload](./images/01.png ':size=90%')
## 子流程
> 不支持
## 运行参数
-* Url: 要下载的URL,HTTP链接。
-* Folder: 保存的目录。
-* Name: 保存的文件名,如果为空,表示使用当前时间作为文件名。
+* 网址
+ > 要下载的URL,仅支持 *http/ https* 链接。
+* 文件夹
+> 保存的目录。
+* 名称
+> 保存的文件名,如果为空,表示使用当前日期/时间作为文件名。
## 输出
-> 保存的文件的完整路径。`Path`
+> 下载的文件的完整路径。参考:[`Path`](../types/Path.md)
-## 脚本调用
+### 资源
-```python
-import simple;
-
-```
-
-### 示例
-
-[https://github.com/shelllet/WinUi/blob/main/http/http_download.simple](https://github.com/shelllet/WinUi/blob/main/http/http_download.simple)
+示例:https://github.com/shelllet/WinUi/blob/main/http/HttpDownload.simple
diff --git a/docx/actions/network/HttpGet.md b/docx/actions/network/HttpGet.md
index 1d63758..756695b 100644
--- a/docx/actions/network/HttpGet.md
+++ b/docx/actions/network/HttpGet.md
@@ -1,5 +1,7 @@
-# Get
-发送基于 *HTTP* 的*Get* 请求
+# GET 请求
+用于向服务器请求指定的资源,HTTP GET 请求应该只接收数据而不改变服务器的状态。
+
+![HttpGet](./images/04.png ':size=90%')
## 子流程
> 不支持
@@ -7,13 +9,17 @@
## 运行参数
-* Url:网址
-
+* 网址
+> 可以在网址中直接包含查询字符串,如:`/test/demo.html?name1=value1&name2=value2`。
+* 标头
+> 在 HTTP GET 请求中传递 HTTP 标头,例如:`Accept: application/json`
+* 参数
+> 查询字符串(名称/值对),在 GET 请求的 URL 中发送:`/test/demo.html?name1=value1&name2=value2`,可选项。
## 输出
-
+> GET 方法返回的内容,参考字符串类型:[String](../types/String.md)
## 脚本调用
@@ -23,4 +29,6 @@ import simple;
```
-## 示例
\ No newline at end of file
+## 资源
+
+示例: https://github.com/shelllet/WinUi/blob/main/network/HttpGet.simple
diff --git a/docx/actions/network/HttpHead.md b/docx/actions/network/HttpHead.md
index 6ded600..90049dc 100644
--- a/docx/actions/network/HttpHead.md
+++ b/docx/actions/network/HttpHead.md
@@ -1,5 +1,7 @@
-# Head
-发送基于 *HTTP* 的*Head* 请求
+# HEAD 请求
+使用 HTTP HEAD 方法从服务器请求 HTTP 标头,就像使用 HTTP GET 方法请求文档一样。HTTP HEAD 和 GET 请求之间的唯一区别是,对于 HTTP HEAD,服务器仅返回标头而不返回正文。
+
+![HttpHead](./images/03.png ':size=90%')
## 子流程
> 不支持
@@ -7,19 +9,14 @@
## 运行参数
-* Url:网址
+* 网址
## 输出
-
-
-
-## 脚本调用
+> 输出 *HEAD* 方法的返回内容,参考类型:[String](../types/String.md)
-```python
-import simple;
-```
+## 资源
-## 示例
\ No newline at end of file
+示例: https://github.com/shelllet/WinUi/blob/main/network/HttpHead.simple
\ No newline at end of file
diff --git a/docx/actions/network/HttpPost.md b/docx/actions/network/HttpPost.md
index b244d4a..591af83 100644
--- a/docx/actions/network/HttpPost.md
+++ b/docx/actions/network/HttpPost.md
@@ -1,5 +1,17 @@
-# Post
-发送基于 *HTTP* 的*Post* 请求
+# POST 请求
+将数据通过 POST 方法发送至服务器用以创建/更新资源,请求主体的类型由 Content-Type 标头指示。该动作使用 超文本传输协议(HTTP/1.1)。
+
+例如:
+
+* application/x-www-form-urlencoded
+ > 这是默认的 Content-Type,键和值被编码在由 分隔的键值元组中 '&','='键和值之间有一个。非字母数字值使用百分比编码进行转义。
+* multipart/form-data
+ > 每个值都作为数据块(正文部分)发送,并用用户代理定义的分隔符(边界)分隔每个部分。
+
+* text/plain
+ > 消息体没有规定的格式,服务器需要进行相应的处理。
+
+![HttpPost](./images/05.png ':size=90%')
## 子流程
> 不支持
@@ -7,20 +19,21 @@
## 运行参数
-* Url:网址
-* ContentType:数据类型
-* Content:数据
+* 网址
+>
+* 数据类型
+> Content-Type 如:`application/json`,要将 JSON 数据发布到服务器。
+* 数据
+> 如果 Content-Type 设置为`application/json`, 请求正文中提供 JSON 数据
-## 输出
-
+## 输出
+> 请求返回的数据,字符串类型,参考:[String](../types/String.md)
-## 脚本调用
-```python
-import simple;
+## 资源
-```
+示例: https://github.com/shelllet/WinUi/blob/main/network/HttpPost.simple
-## 示例
\ No newline at end of file
+!> [Python 3 HTTP/1.1 Server](https://gist.github.com/andystanton/2ec0dca0bf6de90c2000025319f63e2d)
\ No newline at end of file
diff --git a/docx/actions/network/NetworkConnect.md b/docx/actions/network/NetworkConnect.md
new file mode 100644
index 0000000..782200b
--- /dev/null
+++ b/docx/actions/network/NetworkConnect.md
@@ -0,0 +1,28 @@
+# 服务连接
+连接网络服务端。
+
+* *UDP* 是无连接协议,因此 基于*UDP* 协议的网络,可以直接发送或者接收数据。
+
+![NetworkConnect](./images/09.png ':size=90%')
+
+## 子流程
+> 不支持
+
+## 运行参数
+
+
+* 主机
+> 服务器地址,通常包含 *IP* 和端口。参考:[HostAddress](../types/HostAddress.md)
+
+* 类型
+> 网络协议。
+
+## 输出
+> 套接字,可用于读取或者发送数据,*UDP*协议,参考:[UDPSocket](../types/UDPSocket.md)。*TCP*协议,参考:[TCPSocket](../types/TCPSocket.md)。
+
+### 资源
+
+*TCP*示例: https://github.com/shelllet/WinUi/blob/main/network/TcpListen.simple
+*UDP* 示例: https://github.com/shelllet/WinUi/blob/main/network/UdpListen.simple
+
+
diff --git a/docx/actions/network/NetworkListen.md b/docx/actions/network/NetworkListen.md
new file mode 100644
index 0000000..ebc37f4
--- /dev/null
+++ b/docx/actions/network/NetworkListen.md
@@ -0,0 +1,28 @@
+# 网络服务
+创建一个网络服务端。
+
+* *UDP* 是无连接协议,因此 基于*UDP* 协议的网络,直接发送或者接收数据即可,无需监听端口。
+
+![NetworkListen](./images/06.png ':size=90%')
+
+## 子动作
+> 不支持,客户端连接的 *套接字* 会传入子流程中。如果是 *UDP*, 传递参数:[UDPSocket](../types/UDPSocket.md)。如果是*TCP*, 传递参数: [TCPSocket](../types/TCPSocket.md)
+
+## 运行参数
+
+
+* 端口
+> 监听的主机地址,通常包含 *IP* 地址和端口,*IP* 地址可空。参考:[HostAddress](../types/HostAddress.md)
+* 类型
+> 网络协议,支持 *TCP* 或者 *UDP* 协议。
+
+## 输出
+
+> 如果是 *TCP* 协议,返回[TcpServer](../types/TcpServer.md) ,如果是*UDP*协议,返回 [UDPSocket](../types/UDPSocket.md)。
+
+### 资源
+
+*TCP*示例: https://github.com/shelllet/WinUi/blob/main/network/TcpListen.simple
+
+*UDP* 示例: https://github.com/shelllet/WinUi/blob/main/network/UdpListen.simple
+
diff --git a/docx/actions/network/NetworkReceive.md b/docx/actions/network/NetworkReceive.md
new file mode 100644
index 0000000..b8d8e1b
--- /dev/null
+++ b/docx/actions/network/NetworkReceive.md
@@ -0,0 +1,26 @@
+# 数据接收
+接收网络数据。
+
+![NetworkReceive](./images/08.png ':size=90%')
+
+## 子流程
+> 不支持
+
+## 运行参数
+
+* 主机
+
+> 如果是 *TCP* 协议,该参数类型为:[TCPSocket](../types/TCPSocket.md)。如果是*UDP* 协议,该参数是主机地址,参考:[主机地址](../types/HostAddress.md)或者 [UDPSocket](../types/UDPSocket.md)
+
+
+## 输出
+
+> 收到的数据,参考:[字符串](../types/String.md)。
+
+
+## 资源
+
+*TCP*示例: https://github.com/shelllet/WinUi/blob/main/network/TcpListen.simple
+
+*UDP* 示例: https://github.com/shelllet/WinUi/blob/main/network/UdpListen.simple
+
diff --git a/docx/actions/network/NetworkSend.md b/docx/actions/network/NetworkSend.md
new file mode 100644
index 0000000..e368a23
--- /dev/null
+++ b/docx/actions/network/NetworkSend.md
@@ -0,0 +1,27 @@
+# 数据发送
+通过网络,发送数据。
+
+![NetworkSend](./images/07.png ':size=90%')
+
+## 子流程
+> 不支持
+
+## 运行参数
+
+* 主机
+>> 如果是 *TCP* 协议,该参数类型为:[TCPSocket](../types/TCPSocket.md)。如果是*UDP* 协议,该参数是主机地址,参考:[主机地址](../types/HostAddress.md)或者 [UDPSocket](../types/UDPSocket.md)
+
+* 数据
+> 发送的数据。该数据会被序列化成[字符串](../types/String.md)发送。
+
+## 输出
+
+> 如果是 *TCP* 协议,该动作返回:[TCPSocket](../types/TCPSocket.md)。如果是*UDP* 协议,该动作返回: [UDPSocket](../types/UDPSocket.md)
+
+### 资源
+
+*TCP*示例: https://github.com/shelllet/WinUi/blob/main/network/TcpListen.simple
+
+*UDP* 示例: https://github.com/shelllet/WinUi/blob/main/network/UdpListen.simple
+
+
diff --git a/docx/actions/network/TcpConnect.md b/docx/actions/network/TcpConnect.md
deleted file mode 100644
index 236e7e2..0000000
--- a/docx/actions/network/TcpConnect.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# 连接
-此动作通过TCP或者UDP连接服务端。
-
-![action](./images/07.png ':size=90%')
-
-## 子流程
-> 不支持
-
-## 运行参数
-
-
-
-* Host Address: 监听的IP, 默认`127.0.0.1`
-* Port Number: 监听的端口
-* Type: 类型,分为`TCP` 或者`UDP`
-
-## 输出 `Socket`
-
-
-## 脚本调用
-
-```python
-import simple;
-
-```
-
-### 示例
-
-[https://github.com/shelllet/WinUi/blob/main/network/connect.simple](https://github.com/shelllet/WinUi/blob/main/network/connect.simple)
-
-
diff --git a/docx/actions/network/TcpListen.md b/docx/actions/network/TcpListen.md
deleted file mode 100644
index bcd26aa..0000000
--- a/docx/actions/network/TcpListen.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# 监听
-此动作用来创建TCP或者UDP服务端。
-
-![action](./images/01.png ':size=90%')
-
-## 子动作
-> 不支持
-
-## 运行参数
-
-
-* Host Address: 监听的IP, 可忽略,默认`127.0.0.1`
-* Port Number: 监听的端口
-* Type: 类型,分为`TCP` 或者`UDP`
-
-## 输出 无
-
-
-### 脚本调用
-
-```python
-import simple;
-
-```
-
-### 示例
-
-[https://github.com/shelllet/WinUi/blob/main/network/listen.simple](https://github.com/shelllet/WinUi/blob/main/network/listen.simple)
-
diff --git a/docx/actions/network/TcpReceive.md b/docx/actions/network/TcpReceive.md
deleted file mode 100644
index edf3a2c..0000000
--- a/docx/actions/network/TcpReceive.md
+++ /dev/null
@@ -1,28 +0,0 @@
-# 接收
-此动作通过TCP或者UDP接收数据。
-
-![action](./images/05.png ':size=90%')
-
-## 子流程
-> 不支持
-
-## 运行参数
-
-* Socket: 套接字, 可以通过`监听`动作的子动作获取, 或者由`连接`动作获取。
-
-## 输出
-
-> 由`发送`动作所发送的数据。
-
-
-## 脚本调用
-
-```python
-import simple;
-
-```
-
-## 示例
-
-[https://github.com/shelllet/WinUi/blob/main/network/receive.simple](https://github.com/shelllet/WinUi/blob/main/network/receive.simple)
-
diff --git a/docx/actions/network/TcpSend.md b/docx/actions/network/TcpSend.md
deleted file mode 100644
index 0000248..0000000
--- a/docx/actions/network/TcpSend.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# 发送
-此动作通过TCP或者UDP发送数据。
-
-![action](./images/03.png ':size=90%')
-
-## 子流程
-> 不支持
-
-## 运行参数
-
-
-
-* Socket: 套接字, 可以通过`监听`动作的子动作获取, 或者由`连接`动作获取。
-* Value: 发送的数据。
-
-## 输出 无
-
-
-### 脚本调用
-
-```python
-import simple;
-
-```
-
-### 示例
-
-[https://github.com/shelllet/WinUi/blob/main/network/send.simple](https://github.com/shelllet/WinUi/blob/main/network/send.simple)
-
diff --git a/docx/actions/network/VideoDownload.md b/docx/actions/network/VideoDownload.md
new file mode 100644
index 0000000..ebccbaf
--- /dev/null
+++ b/docx/actions/network/VideoDownload.md
@@ -0,0 +1,31 @@
+# 视频下载
+通过提供想要下载视频的 *URL* ,下载相应的视频文件。
+
+![VideoDownload](./images/02.png ':size=90%')
+
+## 子流程
+> 不支持
+
+
+## 运行参数
+
+* 网址
+> 视频链接。
+* 音频
+> 在预览环境时,只输出音频资源。
+
+* 标签
+> 下载的视频*itag*, 可以参考:[YouTube video stream format codes](https://gist.github.com/sidneys/7095afe4da4ae58694d128b1034e01e2), 也可以通过动作预览,获取 *itag*。
+* 输出
+
+> 下载的视频保存的文件夹。
+
+## 输出
+> 保存到本地的视频路径,参考:[Path](../types/Path.md)
+
+
+## 资源
+
+* 示例: https://github.com/shelllet/WinUi/blob/main/network/YoutubeDownload.simple
+
+!> 目前版本只支持 *Youtube*视频下载,中国用户需要能访问 *Youtube* 的代理网络。
\ No newline at end of file
diff --git a/docx/actions/network/YoutubeDownload.md b/docx/actions/network/YoutubeDownload.md
deleted file mode 100644
index 3a10d3b..0000000
--- a/docx/actions/network/YoutubeDownload.md
+++ /dev/null
@@ -1,26 +0,0 @@
-# 视频下载
-目前只支持 *Youtube* 视频下载,需要能访问 *Youtube* 的网络。
-
-## 子流程
-> 不支持
-
-
-## 运行参数
-
-* Url:链接
-* Output:输出目录
-
-
-## 输出
-
-
-
-
-## 脚本调用
-
-```python
-import simple;
-
-```
-
-## 示例
\ No newline at end of file
diff --git a/docx/actions/network/images/01.png b/docx/actions/network/images/01.png
new file mode 100644
index 0000000..2951006
Binary files /dev/null and b/docx/actions/network/images/01.png differ
diff --git a/docx/actions/network/images/02.png b/docx/actions/network/images/02.png
new file mode 100644
index 0000000..6e73a50
Binary files /dev/null and b/docx/actions/network/images/02.png differ
diff --git a/docx/actions/network/images/03.png b/docx/actions/network/images/03.png
new file mode 100644
index 0000000..faf5ce7
Binary files /dev/null and b/docx/actions/network/images/03.png differ
diff --git a/docx/actions/network/images/04.png b/docx/actions/network/images/04.png
new file mode 100644
index 0000000..d88400b
Binary files /dev/null and b/docx/actions/network/images/04.png differ
diff --git a/docx/actions/network/images/05.png b/docx/actions/network/images/05.png
new file mode 100644
index 0000000..e272968
Binary files /dev/null and b/docx/actions/network/images/05.png differ
diff --git a/docx/actions/network/images/06.png b/docx/actions/network/images/06.png
new file mode 100644
index 0000000..d70ae9f
Binary files /dev/null and b/docx/actions/network/images/06.png differ
diff --git a/docx/actions/network/images/07.png b/docx/actions/network/images/07.png
new file mode 100644
index 0000000..063871c
Binary files /dev/null and b/docx/actions/network/images/07.png differ
diff --git a/docx/actions/network/images/08.png b/docx/actions/network/images/08.png
new file mode 100644
index 0000000..bbe0743
Binary files /dev/null and b/docx/actions/network/images/08.png differ
diff --git a/docx/actions/network/images/09.png b/docx/actions/network/images/09.png
new file mode 100644
index 0000000..c6d7cf5
Binary files /dev/null and b/docx/actions/network/images/09.png differ
diff --git a/docx/actions/system/CloseHandle.md b/docx/actions/system/CloseHandle.md
index 7251855..58539e4 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) 匹配
## 输出
@@ -39,4 +39,4 @@ r.run()
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/system/ExistProcess.md b/docx/actions/system/ExistProcess.md
index 950975d..81436ca 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) 匹配
## 输出
@@ -35,4 +35,4 @@ r.run()
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/system/KillProcess.md b/docx/actions/system/KillProcess.md
index c72837f..51f6767 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) 匹配
## 输出
@@ -34,4 +34,4 @@ r.run()
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/system/LaunchFile.md b/docx/actions/system/LaunchFile.md
index ea3a0f7..52ee172 100644
--- a/docx/actions/system/LaunchFile.md
+++ b/docx/actions/system/LaunchFile.md
@@ -37,4 +37,4 @@ r.run()
-
+
diff --git a/docx/actions/system/LoginApplication.md b/docx/actions/system/LoginApplication.md
index 069d2ff..84fc26d 100644
--- a/docx/actions/system/LoginApplication.md
+++ b/docx/actions/system/LoginApplication.md
@@ -43,4 +43,4 @@ r.run()
-
+
diff --git a/docx/actions/system/OpenApplication.md b/docx/actions/system/OpenApplication.md
index a9a163e..2efda35 100644
--- a/docx/actions/system/OpenApplication.md
+++ b/docx/actions/system/OpenApplication.md
@@ -40,4 +40,4 @@ r.run()
-
+
diff --git a/docx/actions/system/OpenUri.md b/docx/actions/system/OpenUri.md
index 8746b24..81273fe 100644
--- a/docx/actions/system/OpenUri.md
+++ b/docx/actions/system/OpenUri.md
@@ -36,4 +36,4 @@ r.run()
-
+
diff --git a/docx/actions/system/ShutdownSystem.md b/docx/actions/system/ShutdownSystem.md
index 602492d..2cb77e2 100644
--- a/docx/actions/system/ShutdownSystem.md
+++ b/docx/actions/system/ShutdownSystem.md
@@ -33,4 +33,4 @@ r.run()
-
+
diff --git a/docx/actions/system/StartProcess.md b/docx/actions/system/StartProcess.md
index 12ab9ed..e92e06c 100644
--- a/docx/actions/system/StartProcess.md
+++ b/docx/actions/system/StartProcess.md
@@ -43,4 +43,4 @@ p.run()
-
+
diff --git a/docx/actions/system/UserAdd.md b/docx/actions/system/UserAdd.md
index c2b6cbd..6cbecd2 100644
--- a/docx/actions/system/UserAdd.md
+++ b/docx/actions/system/UserAdd.md
@@ -40,6 +40,6 @@ p.run()
-
+
diff --git a/docx/actions/system/Wait.md b/docx/actions/system/Wait.md
index 2bbe4fa..dbe49f9 100644
--- a/docx/actions/system/Wait.md
+++ b/docx/actions/system/Wait.md
@@ -35,4 +35,4 @@ w.run()
-
+
diff --git a/docx/actions/media/CaptureForground.md b/docx/actions/type/TypeDict.md
similarity index 52%
rename from docx/actions/media/CaptureForground.md
rename to docx/actions/type/TypeDict.md
index 082bd2f..343cce8 100644
--- a/docx/actions/media/CaptureForground.md
+++ b/docx/actions/type/TypeDict.md
@@ -1,18 +1,15 @@
-# 前置窗口截图
-前置窗口截图。
+# 字典
+定义一个 `Dict`(字典) 类型。
## 子流程
-> 不支持
-
+> 支持
## 运行参数
-
-
## 输出
-> 图像
+> [`Dict`](./types/Dict.md)
## 脚本调用
diff --git a/docx/actions/type/TypeTuple.md b/docx/actions/type/TypeTuple.md
new file mode 100644
index 0000000..781277b
--- /dev/null
+++ b/docx/actions/type/TypeTuple.md
@@ -0,0 +1,27 @@
+# 字典
+定义一个 `Tuple`(元组) 类型。
+
+## 子流程
+> 支持
+
+## 运行参数
+
+* 名称
+> 元组的第 1 个元素。
+
+* 数据
+> 元组的第 2 个元素。
+
+## 输出
+
+> [`Tuple`](./types/Tuple.md)
+
+
+## 脚本调用
+
+```python
+import simple;
+
+```
+
+## 示例
\ No newline at end of file
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/EnumWindows.md b/docx/actions/window/EnumWindows.md
index 8c3a15f..39500cc 100644
--- a/docx/actions/window/EnumWindows.md
+++ b/docx/actions/window/EnumWindows.md
@@ -1,5 +1,8 @@
# 枚举窗口
-枚举操作系统中的窗口
+枚举操作系统中的窗口,并按照窗口所在进程的创建时间进行排序。
+
+
+* 注意:当这些窗口属于同一进程,则无法排序 ,例如 *Win11* 系统中的计算器,
![EnumWindows](./images/10.png ':size=90%')
@@ -32,4 +35,4 @@ import simple;
-
+
diff --git a/docx/actions/window/FindWindow.md b/docx/actions/window/FindWindow.md
index 006d568..0e338c5 100644
--- a/docx/actions/window/FindWindow.md
+++ b/docx/actions/window/FindWindow.md
@@ -38,7 +38,7 @@ w.run()
-
+
!> [Windows下的程序及热键监视神器——Spy++](https://zhuanlan.zhihu.com/p/355878952)
diff --git a/docx/actions/window/FlashWindow.md b/docx/actions/window/FlashWindow.md
new file mode 100644
index 0000000..2608bc9
--- /dev/null
+++ b/docx/actions/window/FlashWindow.md
@@ -0,0 +1,20 @@
+# 闪烁窗口
+闪烁指定的窗口,它不会更改窗口的活动状态。
+
+![FlashWindow](./images/14.png ':size=90%')
+
+## 子流程
+
+> 不支持
+
+## 运行参数
+
+* 窗口
+
+## 输出
+
+> 无
+
+## 资源
+
+示例:https://github.com/shelllet/WinUi/blob/main/window/FlashWindow.simple
diff --git a/docx/actions/window/ForegroundWindow.md b/docx/actions/window/ForegroundWindow.md
index 45da2c8..74a1b71 100644
--- a/docx/actions/window/ForegroundWindow.md
+++ b/docx/actions/window/ForegroundWindow.md
@@ -30,6 +30,6 @@ import simple;
-
+
-!> 不无前置最小化的窗口
\ No newline at end of file
+!> 无法前置最小化的窗口
\ No newline at end of file
diff --git a/docx/actions/window/MessageBox.md b/docx/actions/window/MessageBox.md
index 4f4dd59..a8026e0 100644
--- a/docx/actions/window/MessageBox.md
+++ b/docx/actions/window/MessageBox.md
@@ -37,6 +37,6 @@ Wnd.MessageBox('caption', 'msg', flags)
-
+
!> 消息框关闭之后,才会继续执行后续动作。
\ No newline at end of file
diff --git a/docx/actions/window/PositionWindow.md b/docx/actions/window/PositionWindow.md
index 4fbe362..a103c8b 100644
--- a/docx/actions/window/PositionWindow.md
+++ b/docx/actions/window/PositionWindow.md
@@ -34,6 +34,6 @@ import simple;
-
+
!> 对于 *UWP* 应用解决办法参考:https://github.com/microsoft/Xaml-Islands-Samples/blob/master/Samples/Win32/SampleCppApp/ReadMe.md
\ No newline at end of file
diff --git a/docx/actions/window/SpecialWindow.md b/docx/actions/window/SpecialWindow.md
index 18846d9..fe3a8e0 100644
--- a/docx/actions/window/SpecialWindow.md
+++ b/docx/actions/window/SpecialWindow.md
@@ -31,4 +31,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/window/WinRun.md b/docx/actions/window/WinRun.md
index cac36b6..911cb17 100644
--- a/docx/actions/window/WinRun.md
+++ b/docx/actions/window/WinRun.md
@@ -29,7 +29,7 @@ import simple;
-
+
* 操作系统中的运行框
> ![操作系统中的运行框](./images/01.png ':size=40%')
diff --git a/docx/actions/window/WindowAncestor.md b/docx/actions/window/WindowAncestor.md
index 61d1a02..7b2f9d9 100644
--- a/docx/actions/window/WindowAncestor.md
+++ b/docx/actions/window/WindowAncestor.md
@@ -32,4 +32,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/window/WindowCaption.md b/docx/actions/window/WindowCaption.md
index dd03e74..4078e17 100644
--- a/docx/actions/window/WindowCaption.md
+++ b/docx/actions/window/WindowCaption.md
@@ -33,4 +33,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/window/WindowPoint.md b/docx/actions/window/WindowPoint.md
index 1ef1662..59224cd 100644
--- a/docx/actions/window/WindowPoint.md
+++ b/docx/actions/window/WindowPoint.md
@@ -42,4 +42,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/window/WindowSize.md b/docx/actions/window/WindowSize.md
index ce00bc0..520dae4 100644
--- a/docx/actions/window/WindowSize.md
+++ b/docx/actions/window/WindowSize.md
@@ -32,4 +32,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/window/WindowVisible.md b/docx/actions/window/WindowVisible.md
index 60b155e..1fb04d9 100644
--- a/docx/actions/window/WindowVisible.md
+++ b/docx/actions/window/WindowVisible.md
@@ -32,4 +32,4 @@ import simple;
-
+
diff --git a/docx/actions/window/WindowXy.md b/docx/actions/window/WindowXy.md
index 5e250ed..60b2902 100644
--- a/docx/actions/window/WindowXy.md
+++ b/docx/actions/window/WindowXy.md
@@ -32,4 +32,4 @@ import simple;
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docx/actions/window/images/14.png b/docx/actions/window/images/14.png
new file mode 100644
index 0000000..0456dfe
Binary files /dev/null and b/docx/actions/window/images/14.png differ
diff --git a/docx/enums/KnownFolder.md b/docx/enums/KnownFolder.md
new file mode 100644
index 0000000..14eda03
--- /dev/null
+++ b/docx/enums/KnownFolder.md
@@ -0,0 +1,8 @@
+# KnownFolder
+
+* Downloads
+> 下载
+* Documents
+> 我的文档
+* LocalAppData
+>
\ 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..8ff0f5c 100644
--- a/docx/index.html
+++ b/docx/index.html
@@ -8,7 +8,10 @@
-
+
+
+
+
@@ -52,6 +55,16 @@
},
]
}
+
+ const gitalk = new Gitalk({
+ clientID: '1950547cecdacae2a71a',
+ clientSecret: 'ecada96501418c89375751dc8e412af679db4285',
+ repo: 'winui',
+ owner: 'shelllet',
+ admin: ['shelllet'],
+ distractionFreeMode: false
+ })
+
@@ -60,6 +73,7 @@
+