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