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