自动化编辑器-插件教程

自动化编辑器-插件教程


查找窗口

<h1>查找窗口</h1> <h2>功能描述</h2> <p>根据窗口标题和类名模糊查找窗口,仅支持 PC 环境。</p> <h2>输入参数</h2> <ul> <li><strong>窗口标题</strong>:字符串(如 <code>&amp;quot;记事本&amp;quot;</code>)</li> <li><strong>窗口类名</strong>:字符串(如 <code>&amp;quot;Notepad&amp;quot;</code>)</li> </ul> <h2>输出结果</h2> <ul> <li><strong>执行结果</strong>:   - <code>true</code>(成功时)   - <code>false</code>(失败时)</li> <li><strong>窗口句柄</strong>:成功时返回窗口句柄(如 <code>&amp;quot;123456&amp;quot;</code>)</li> <li><strong>窗口标题</strong>:成功时返回窗口标题(如 <code>&amp;quot;记事本&amp;quot;</code>)</li> <li><strong>窗口类名</strong>:成功时返回窗口类名(如 <code>&amp;quot;Notepad&amp;quot;</code>)</li> <li><strong>窗口位置</strong>:成功时返回窗口位置(如 <code>&amp;quot;{x: 100, y: 200, width: 300, height: 400}&amp;quot;</code>)</li> </ul> <h2>日志记录</h2> <ul> <li>输入参数:   - <code>窗口标题: &amp;quot;记事本&amp;quot;</code>   - <code>窗口类名: &amp;quot;Notepad&amp;quot;</code></li> <li>输出结果:   - <code>执行结果: true</code> 或 <code>false</code>   - <code>窗口句柄: &amp;quot;123456&amp;quot;</code>(成功时)   - <code>窗口标题: &amp;quot;记事本&amp;quot;</code>(成功时)   - <code>窗口类名: &amp;quot;Notepad&amp;quot;</code>(成功时)   - <code>窗口位置: &amp;quot;{x: 100, y: 200, width: 300, height: 400}&amp;quot;</code>(成功时)</li> <li>日志信息:   - <code>找到窗口: {&amp;quot;hwnd&amp;quot;: &amp;quot;123456&amp;quot;, &amp;quot;title&amp;quot;: &amp;quot;记事本&amp;quot;, &amp;quot;class_name&amp;quot;: &amp;quot;Notepad&amp;quot;, &amp;quot;rect&amp;quot;: &amp;quot;{x: 100, y: 200, width: 300, height: 400}&amp;quot;}</code>(成功时)   - <code>未找到匹配的窗口</code>(失败时)   - <code>查找窗口失败: 错误信息</code>(失败时)   - <code>查找窗口功能仅支持在PC环境下使用</code>(非 PC 环境时)</li> </ul> <h2>示例</h2> <h3>场景 1:查找成功</h3> <ul> <li><strong>输入参数</strong>:   - 窗口标题:<code>&amp;quot;记事本&amp;quot;</code>   - 窗口类名:<code>&amp;quot;Notepad&amp;quot;</code></li> <li><strong>输出结果</strong>:   - <code>执行结果: true</code>   - <code>窗口句柄: &amp;quot;123456&amp;quot;</code>   - <code>窗口标题: &amp;quot;记事本&amp;quot;</code>   - <code>窗口类名: &amp;quot;Notepad&amp;quot;</code>   - <code>窗口位置: &amp;quot;{x: 100, y: 200, width: 300, height: 400}&amp;quot;</code></li> <li><strong>日志输出</strong>:   - <code>找到窗口: {&amp;quot;hwnd&amp;quot;: &amp;quot;123456&amp;quot;, &amp;quot;title&amp;quot;: &amp;quot;记事本&amp;quot;, &amp;quot;class_name&amp;quot;: &amp;quot;Notepad&amp;quot;, &amp;quot;rect&amp;quot;: &amp;quot;{x: 100, y: 200, width: 300, height: 400}&amp;quot;}</code></li> </ul> <h3>场景 2:查找失败(未找到窗口)</h3> <ul> <li><strong>输入参数</strong>:   - 窗口标题:<code>&amp;quot;不存在的窗口&amp;quot;</code>   - 窗口类名:<code>&amp;quot;InvalidClass&amp;quot;</code></li> <li><strong>输出结果</strong>:   - <code>执行结果: false</code></li> <li><strong>日志输出</strong>:   - <code>未找到匹配的窗口</code></li> </ul> <h3>场景 3:查找失败(非 PC 环境)</h3> <ul> <li><strong>输入参数</strong>:   - 窗口标题:<code>&amp;quot;记事本&amp;quot;</code>   - 窗口类名:<code>&amp;quot;Notepad&amp;quot;</code></li> <li><strong>输出结果</strong>:   - <code>执行结果: false</code></li> <li><strong>日志输出</strong>:   - <code>查找窗口功能仅支持在PC环境下使用</code></li> </ul>

页面列表

ITEM_HTML