update

shelllet · Dec 21, 2023 · ea69bd6 · ea69bd6
1 parent 6573bcf
commit ea69bd6
Show file tree

Hide file tree

Showing 33 changed files with 116 additions and 84 deletions.
diff --git 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
@@ -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
@@ -48,4 +48,9 @@ import simple;
 
 <iframe type="text/html" height="640px" src="https://www.youtube.com/embed/CKI7oQo0idA" frameborder="0"></iframe>
 
-<iframe src="//player.bilibili.com/player.html?bvid=BV16u4y1a76i&page=1&autoplay=0" height='640px' scrolling="no" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>
+<iframe src="//player.bilibili.com/player.html?bvid=BV16u4y1a76i&page=1&autoplay=0" height='640px' scrolling="no" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>
+
+## 版本变化
+
+* 0.31
+> 图像参数支持使用*窗口*类型。
diff --git a/docx/actions/detection/EllipseDetection.md b/docx/actions/detection/EllipseDetection.md
@@ -37,4 +37,9 @@ import simple;
 
 <iframe type="text/html" height="640px" src="https://www.youtube.com/embed/yAU-tTiaAOg" frameborder="0"></iframe>
 
-<iframe src="//player.bilibili.com/player.html?bvid=BV1CN4y1r7Sk&page=1&autoplay=0" height='640px' scrolling="no" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>
+<iframe src="//player.bilibili.com/player.html?bvid=BV1CN4y1r7Sk&page=1&autoplay=0" height='640px' scrolling="no" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>
+
+## 版本变化
+
+* 0.31
+> 图像参数支持使用*窗口*类型。
diff --git a/docx/actions/detection/FeatureDetect.md b/docx/actions/detection/FeatureDetect.md
@@ -42,4 +42,10 @@ import simple;
 <iframe src="//player.bilibili.com/player.html?bvid=BV1bc411f7pH&page=1&autoplay=0" height='640px' scrolling="no" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>
 
 
-!> 该动作会先将源图像和模板图像转换成灰度图像，再进行匹配。
+!> 该动作会先将源图像和模板图像转换成灰度图像，再进行匹配。
+
+
+## 版本变化
+
+* 0.31
+> 图像参数支持使用*窗口*类型。
diff --git a/docx/actions/detection/FindContours.md b/docx/actions/detection/FindContours.md
@@ -38,3 +38,9 @@ import simple;
 <iframe type="text/html" height="640px" src="https://www.youtube.com/embed/jhWW91Lo8mQ" frameborder="0"></iframe>
 
 <iframe src="//player.bilibili.com/player.html?bvid=BV15e411X7YX&page=1&autoplay=0" height='640px' scrolling="no" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>
+
+
+## 版本变化
+
+* 0.31
+> 图像参数支持使用*窗口*类型。
diff --git a/docx/actions/detection/LineDetection.md b/docx/actions/detection/LineDetection.md
@@ -39,4 +39,10 @@ import simple;
 
 <iframe type="text/html" height="640px" src="https://www.youtube.com/embed/GDqQxHO8NR0" frameborder="0"></iframe>
 
-<iframe src="//player.bilibili.com/player.html?bvid=BV1xy4y1P7eE&page=1&autoplay=0" height='640px' scrolling="no" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>
+<iframe src="//player.bilibili.com/player.html?bvid=BV1xy4y1P7eE&page=1&autoplay=0" height='640px' scrolling="no" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>
+
+
+## 版本变化
+
+* 0.31
+> 图像参数支持使用*窗口*类型。
diff --git a/docx/actions/detection/MatchShapes.md b/docx/actions/detection/MatchShapes.md
@@ -40,4 +40,9 @@ import simple;
 
 <iframe type="text/html" height="640px" src="https://www.youtube.com/embed/QCie2BH1qik" frameborder="0"></iframe>
 
-<iframe src="//player.bilibili.com/player.html?bvid=BV1VG411y7jh&page=1&autoplay=0" height='640px' scrolling="no" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>
+<iframe src="//player.bilibili.com/player.html?bvid=BV1VG411y7jh&page=1&autoplay=0" height='640px' scrolling="no" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>
+
+## 版本变化
+
+* 0.31
+> 图像参数支持使用*窗口*类型。
diff --git a/docx/actions/detection/MatchTemplate.md b/docx/actions/detection/MatchTemplate.md
@@ -40,3 +40,8 @@ import simple;
 <iframe type="text/html" height="640px" src="https://www.youtube.com/embed/yW83dUrNDoo" frameborder="0"></iframe>
 
 <iframe src="//player.bilibili.com/player.html?bvid=BV1Pu4y1772u&page=1&autoplay=0" height='640px' scrolling="no" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>
+
+## 版本变化
+
+* 0.31
+> 图像参数支持使用*窗口*类型。
diff --git a/docx/actions/detection/ShapeDetection.md b/docx/actions/detection/ShapeDetection.md
@@ -40,4 +40,9 @@ import simple;
 
 <iframe type="text/html" height="640px" src="https://www.youtube.com/embed/NRlkMqjheZE" frameborder="0"></iframe>
 
-<iframe src="//player.bilibili.com/player.html?bvid=BV1gw411z7Z2&page=1&autoplay=0" height='640px' scrolling="no" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>
+<iframe src="//player.bilibili.com/player.html?bvid=BV1gw411z7Z2&page=1&autoplay=0" height='640px' scrolling="no" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>
+
+## 版本变化
+
+* 0.31
+> 图像参数支持使用*窗口*类型。
diff --git a/docx/actions/keyboard/SendKey.md b/docx/actions/keyboard/SendKey.md
@@ -4,35 +4,36 @@
 ![SendKey](./images/04.png ':size=90%')
 
 ## 权限
-> 据 *UIC* 规则，不能向高权限的用户界面发送按键，例如：普通用户启动的 *WinUi++*, 无法向以管理员方式启动的应用界面发送按键。
+> 据 *UIC* 规则，不能向高权限的用户界面发送按键，例如：普通用户启动的 *WinUi++*, 无法向以管理员方式启动的应用程序窗口发送按键。
 
 ## 子流程
 > 不支持
 
 
 ## 运行参数
 
+* 窗口
+> 需要激活的窗口，默认当前激活的窗口。
 * 按键
+> 发送的键盘按键。
 * 延迟
   > 发送完按键之后所等待的时间,单位：秒
 
 
 ## 输出
->  无    
+>  发送的键盘按键， 参考：    
 
 
-## 脚本调用
-> 参考 [Keyboard](./types/Keyboard.md)
-
-```python
-import simple;
-
-```
-
 ## 资源
 
 * 流程：https://github.com/shelllet/WinUi/blob/main/keyboard/SendKey.simple
 
 <iframe type="text/html" height="640px" src="https://www.youtube.com/embed/84TvkrTkjQk" frameborder="0"></iframe>
 
-<iframe src="//player.bilibili.com/player.html?bvid=BV1zu411J7FP&page=1&autoplay=0" height='640px' scrolling="no" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>
+<iframe src="//player.bilibili.com/player.html?bvid=BV1zu411J7FP&page=1&autoplay=0" height='640px' scrolling="no" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>
+
+
+## 版本变化
+
+* 0.31
+> 增加 *窗口* 运行参数。
diff --git a/docx/actions/media/images/05.png b/docx/actions/media/images/05.png
diff --git 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
@@ -1,6 +1,8 @@
 # GET 请求
 用于向服务器请求指定的资源，HTTP GET 请求应该只接收数据而不改变服务器的状态。
 
+![HttpGet](./images/04.png ':size=90%')
+
 ## 子流程
 > 不支持
 
@@ -27,4 +29,6 @@ import simple;
 
 ```
 
-## 资源
+## 资源
+
+示例： https://github.com/shelllet/WinUi/blob/main/network/HttpGet.simple
diff --git 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;
-
-```
+## 资源
 
-## 示例
+示例： https://github.com/shelllet/WinUi/blob/main/network/HttpHead.simple
diff --git 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)
diff --git 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
@@ -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
@@ -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
@@ -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
@@ -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* 的代理网络。
diff --git a/docx/actions/network/images/01.png b/docx/actions/network/images/01.png
diff --git a/docx/actions/network/images/02.png b/docx/actions/network/images/02.png
diff --git a/docx/actions/network/images/03.png b/docx/actions/network/images/03.png
diff --git a/docx/actions/network/images/04.png b/docx/actions/network/images/04.png
diff --git a/docx/actions/network/images/05.png b/docx/actions/network/images/05.png
diff --git a/docx/actions/network/images/06.png b/docx/actions/network/images/06.png
diff --git a/docx/actions/network/images/07.png b/docx/actions/network/images/07.png
diff --git a/docx/actions/network/images/08.png b/docx/actions/network/images/08.png
diff --git a/docx/actions/network/images/09.png b/docx/actions/network/images/09.png