在按键精灵的自动化开发中，窗口句柄是操作第三方窗口的核心标识。只有准确获取目标窗口的句柄，才能顺利执行后台点击、文本输入、窗口移动等自动化动作。按键精灵针对不同实际需求，提供了多种获取窗口句柄的方式。以下从典型使用场景出发，分别介绍各类实现方法。
按窗口标题获取：新手入门的基础方式
该方式适用于目标窗口标题固定不变的场景，也是初学者最容易上手的方法。按键精灵内置的 findwindow 命令支持直接按窗口标题匹配，示例代码为：hwnd = plugin.window.find(0, "无 - 记事本")
其中第一个参数填 0 表示不限制窗口类名，仅依据窗口标题进行模糊匹配。该方法编写简单，无需预先探测窗口属性，但对动态标题适配能力较弱——例如 Word 文档标题常随文件名变化（如“报告.docx - Word”），容易导致匹配失败。
按窗口类名获取：面向动态标题的稳定方案
多数桌面应用程序的窗口类名具有稳定性，即使窗口标题频繁更新，其类名通常保持不变。此时采用类名匹配可显著提升脚本鲁棒性。同样调用 findwindow 命令，只需调整参数顺序，示例代码为：hwnd = plugin.window.find("notepad", 0)
第二个参数设为 0 表示不限制窗口标题，仅通过固定类名即可定位目标窗口。开发者可借助按键精灵自带的“抓抓”工具，将探测准星拖拽至目标窗口，实时读取窗口类名、标题、句柄等关键信息，操作直观高效。该方式广泛应用于中大型自动化脚本开发中。
鼠标点选获取：面向终端用户的交互式方案
当脚本需由最终用户自主指定目标窗口，或处于快速验证阶段时，鼠标点选是最灵活的选择。仅需一行代码即可完成：hwnd = plugin.window.mousepoint()
运行后，脚本会提示用户将鼠标移至目标窗口任意位置并单击，随即自动捕获该窗口句柄。整个过程无需预知标题或类名，兼容任意类型窗口。局限在于无法脱离人工干预实现全自动运行，必须依赖手动触发。
枚举遍历获取：应对多实例窗口的高级方案
当系统中存在多个同名标题或同类名的窗口（如同时打开多个 Chrome 标签页或 Excel 工作簿）时，需精准筛选特定实例，此时应采用枚举遍历方式。通过 enumwindows 命令遍历所有顶层窗口，逐个调用 getwindowrect、iswindowvisible 等辅助命令获取尺寸、坐标、可见性等属性，并结合自定义逻辑（如判断窗口宽度是否大于800、是否位于屏幕右半区等）筛选出唯一目标句柄。该方法灵活性最强，可覆盖绝大多数复杂窗口管理场景，仅在开发复杂度上略高于基础方式。
