diff --git a/docx/CHANGELOG.md b/docx/CHANGELOG.md
index 895b3ca..2fe6d5a 100644
--- a/docx/CHANGELOG.md
+++ b/docx/CHANGELOG.md
@@ -7,10 +7,13 @@
3. *For*(循环)动作名称变更为 *Iterate*(迭代)动作,功能不变。
4. *IterParam*(迭代参数)动作名称变更为 *Param*(参数)动作,并支持设置默认参数,功能不变。
5. 增加 *StandardPath*(标准路径)动作,用来表示系统常用路径。
+5. 增加 *FlashWindow*(闪烁窗口)动作,用来闪烁窗口,定位多个相同名称/类名的窗口。
+6. 优化网络相关动作
### Deprecated:
1. *前置窗口截图* 动作弃用,请使用 [*窗口截图*](./actions/media/CaptureWindow.md) 动作。
+1. *窗口筛选* 动作弃用,请使用 [*EnumWindows*](./actions/window/EnumWindows.md) 动作。
### 备注
diff --git a/docx/_sidebar.md b/docx/_sidebar.md
index 52a7407..184e35b 100644
--- a/docx/_sidebar.md
+++ b/docx/_sidebar.md
@@ -76,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)
diff --git a/docx/actions/detection/BlobDetect.md b/docx/actions/detection/BlobDetect.md
index de11b3b..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 01128dd..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 094e5f4..b9d81fe 100644
--- a/docx/actions/detection/FeatureDetect.md
+++ b/docx/actions/detection/FeatureDetect.md
@@ -42,4 +42,10 @@ 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 cfd689c..3b3f81a 100644
--- a/docx/actions/detection/FindContours.md
+++ b/docx/actions/detection/FindContours.md
@@ -38,3 +38,9 @@ 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 4ac000b..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 2b8ab65..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 f099008..6270fc7 100644
--- a/docx/actions/detection/MatchTemplate.md
+++ b/docx/actions/detection/MatchTemplate.md
@@ -40,3 +40,8 @@ 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 85e9a7e..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/keyboard/SendKey.md b/docx/actions/keyboard/SendKey.md
index eb5678d..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/media/images/05.png b/docx/actions/media/images/05.png
index b3c09de..2df6d9e 100644
Binary files a/docx/actions/media/images/05.png and b/docx/actions/media/images/05.png differ
diff --git a/docx/actions/network/HttpDownload.md b/docx/actions/network/HttpDownload.md
index 858a0c2..6bc59ab 100644
--- a/docx/actions/network/HttpDownload.md
+++ b/docx/actions/network/HttpDownload.md
@@ -21,13 +21,6 @@
-## 脚本调用
-
-```python
-import 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 431fc43..756695b 100644
--- a/docx/actions/network/HttpGet.md
+++ b/docx/actions/network/HttpGet.md
@@ -1,6 +1,8 @@
# GET 请求
用于向服务器请求指定的资源,HTTP GET 请求应该只接收数据而不改变服务器的状态。
+![HttpGet](./images/04.png ':size=90%')
+
## 子流程
> 不支持
@@ -27,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 551ab9f..90049dc 100644
--- a/docx/actions/network/HttpHead.md
+++ b/docx/actions/network/HttpHead.md
@@ -1,5 +1,8 @@
# HEAD 请求
使用 HTTP HEAD 方法从服务器请求 HTTP 标头,就像使用 HTTP GET 方法请求文档一样。HTTP HEAD 和 GET 请求之间的唯一区别是,对于 HTTP HEAD,服务器仅返回标头而不返回正文。
+
+![HttpHead](./images/03.png ':size=90%')
+
## 子流程
> 不支持
@@ -14,11 +17,6 @@
> 输出 *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 c000cd8..591af83 100644
--- a/docx/actions/network/HttpPost.md
+++ b/docx/actions/network/HttpPost.md
@@ -1,4 +1,4 @@
-# Post
+# POST 请求
将数据通过 POST 方法发送至服务器用以创建/更新资源,请求主体的类型由 Content-Type 标头指示。该动作使用 超文本传输协议(HTTP/1.1)。
例如:
@@ -11,6 +11,8 @@
* text/plain
> 消息体没有规定的格式,服务器需要进行相应的处理。
+![HttpPost](./images/05.png ':size=90%')
+
## 子流程
> 不支持
@@ -30,14 +32,8 @@
> 请求返回的数据,字符串类型,参考:[String](../types/String.md)
-## 脚本调用
-
-```python
-import simple;
-
-```
-
## 资源
+示例: https://github.com/shelllet/WinUi/blob/main/network/HttpPost.simple
!> [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
index ac925ac..782200b 100644
--- a/docx/actions/network/NetworkConnect.md
+++ b/docx/actions/network/NetworkConnect.md
@@ -3,7 +3,7 @@
* *UDP* 是无连接协议,因此 基于*UDP* 协议的网络,可以直接发送或者接收数据。
-![NetworkConnect](./images/07.png ':size=90%')
+![NetworkConnect](./images/09.png ':size=90%')
## 子流程
> 不支持
@@ -20,14 +20,7 @@
## 输出
> 套接字,可用于读取或者发送数据,*UDP*协议,参考:[UDPSocket](../types/UDPSocket.md)。*TCP*协议,参考:[TCPSocket](../types/TCPSocket.md)。
-## 脚本调用
-
-```python
-import simple;
-
-```
-
-### 示例
+### 资源
*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
index f16762e..ebc37f4 100644
--- a/docx/actions/network/NetworkListen.md
+++ b/docx/actions/network/NetworkListen.md
@@ -3,7 +3,7 @@
* *UDP* 是无连接协议,因此 基于*UDP* 协议的网络,直接发送或者接收数据即可,无需监听端口。
-![NetworkListen](./images/01.png ':size=90%')
+![NetworkListen](./images/06.png ':size=90%')
## 子动作
> 不支持,客户端连接的 *套接字* 会传入子流程中。如果是 *UDP*, 传递参数:[UDPSocket](../types/UDPSocket.md)。如果是*TCP*, 传递参数: [TCPSocket](../types/TCPSocket.md)
@@ -20,15 +20,9 @@
> 如果是 *TCP* 协议,返回[TcpServer](../types/TcpServer.md) ,如果是*UDP*协议,返回 [UDPSocket](../types/UDPSocket.md)。
-### 脚本调用
-
-```python
-import simple;
-
-```
-
### 资源
*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
index 5fe35f3..b8d8e1b 100644
--- a/docx/actions/network/NetworkReceive.md
+++ b/docx/actions/network/NetworkReceive.md
@@ -1,7 +1,7 @@
# 数据接收
接收网络数据。
-![NetworkReceive](./images/05.png ':size=90%')
+![NetworkReceive](./images/08.png ':size=90%')
## 子流程
> 不支持
@@ -18,15 +18,9 @@
> 收到的数据,参考:[字符串](../types/String.md)。
-## 脚本调用
-
-```python
-import simple;
-
-```
-
-## 示例
+## 资源
*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
index 7efd44d..e368a23 100644
--- a/docx/actions/network/NetworkSend.md
+++ b/docx/actions/network/NetworkSend.md
@@ -1,7 +1,7 @@
# 数据发送
通过网络,发送数据。
-![NetworkSend](./images/03.png ':size=90%')
+![NetworkSend](./images/07.png ':size=90%')
## 子流程
> 不支持
@@ -18,16 +18,10 @@
> 如果是 *TCP* 协议,该动作返回:[TCPSocket](../types/TCPSocket.md)。如果是*UDP* 协议,该动作返回: [UDPSocket](../types/UDPSocket.md)
-### 脚本调用
-
-```python
-import simple;
-
-```
-
-### 示例
+### 资源
*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/VideoDownload.md b/docx/actions/network/VideoDownload.md
index 865800a..ebccbaf 100644
--- a/docx/actions/network/VideoDownload.md
+++ b/docx/actions/network/VideoDownload.md
@@ -1,6 +1,8 @@
# 视频下载
通过提供想要下载视频的 *URL* ,下载相应的视频文件。
+![VideoDownload](./images/02.png ':size=90%')
+
## 子流程
> 不支持
@@ -22,15 +24,8 @@
> 保存到本地的视频路径,参考:[Path](../types/Path.md)
-
-## 脚本调用
-
-```python
-import simple;
-
-```
-
## 资源
+* 示例: https://github.com/shelllet/WinUi/blob/main/network/YoutubeDownload.simple
!> 目前版本只支持 *Youtube*视频下载,中国用户需要能访问 *Youtube* 的代理网络。
\ 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/window/EnumWindows.md b/docx/actions/window/EnumWindows.md
index ac67c52..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%')
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/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