Au3Chm 函数询捕
本帖最后由 afan 于 2024-1-5 21:26 编辑大版本更新到 2.x，支持全文搜索(最实用之处是可在全部的示例源码中搜索函数或其它关键词的使用，如果你懂我说的，一定会让你惊奇。不懂的话，用1.5版即可)。
函数询捕一直以来都是搜索标题、宏等少量关键字，这是最实用的，但有时仍有全文搜索的需求，而chm文档自身的搜索大部分区域根本未触及。2.0版新开发全文搜索，只要是chm文档中存在的任意一个字符，均可搜索到，且结果页面无重复。
该版起不再公开发布，仅会限时与关注与评分的朋友共享(到9月17日止，现已截止)。
BTW, 由于无任何反馈，赠送的注册版也止步于2.3.1版，自2.4版起，仅对购买注册版的用户提供升级及支持(购买注册版活动已过期，已不再提供)。
〓最近更新〓：
20240105 更新 3.4.6
[修正]两个宏 @ComSpec @OSVersion 无法被搜索到的问题
[修正]在线更新连接问题
20230314 更新 3.4.5
[新增]增加“智能F1”的另一新功能(续)
在鼠标光标与当前插入符同行时，点击的不是函数，而是函数之后的参数时
同样的，如果该函数已有语法帮助，则直接显示该参数的解释、函数名及参数位
对于比较长的参数或比较多的参数位参数，有时就算分行书写也不好分辨参数的意义或位置
现在只需在需要查询的参数上点击一下(鼠标不要移出该行)，按 F1 即可
20230313 更新 3.4
[新增]增加“智能F1”的另一新功能
一般情况下，输入函数名后，会弹出语法提示窗，以明示函数作用及参数解释
该提示很直观，但仅在新输入函数时才会弹出，之后想再次查看却不容易调出
现在“智能F1”可以随时查看，极其方便：
上版已对鼠标光标在当前插入符的上方或下方做出了不同的功能，现在新增的功能
触发条件则是鼠标光标与当前插入符同行(相当于点击了函数名之后未上下移动的状态)
在要查看的函数名中间或边界处任意位置点击一下(不需要选择)，按 F1
如果该函数已有语法帮助，则立显提示。这样就连帮助文档都无需打开了…
20230307 更新 3.3.3
[新增]为 SciTE 定制的“智能F1”以查阅不同帮助文档功能
在 SciTE 编辑器中按 F1 查看帮助时只能查看于固定名为 AutoIt.chm 的文档
对于有汉化版和英文版切换阅读的需求时，一般只能互相重命名，十分繁琐不便
对此，本工具设计了一种解决方案，点击主菜单的“设置 > 智能F1功能…”
选择“添加此功能”，再选择另一个需要查阅的chm文件，应用后即可使用
该功能的作用为：
点击需要查询的关键字后，在按 F1 时，鼠标光标若在当前插入符上方则查阅另选的chm文档
反之，若在下方则查阅原文档，简直不要太方便
注：若当前关键字未在对应的文档中则始终查阅原文档
[修正]启动时判断窗口是否超出屏幕
在屏幕分辨率较大的情况下，窗口处于右下角时退出
在较小分辨率启动时，会因为超出范围而可能导致无法显示
现已修正为超出屏幕时自动变更为合适的坐标
；F8C02BACE117B03E8FEC87C911FA2E446D9079F3129FAD230BAA04DBFD884D0E191D3B8F4B8C5F310448E419645C937CF91A1EEDFECE9D8DC10FB65C155902EEF9BAD5D75005ED359757D647A31396AAA0FE
20210910 更新 3.3.2
[修正]因论坛cn域名的网址已失效，修正“关于”里的访问发布帖地址，以便直达
[修正]检测更新失效的问题
[修改]释放内存机制
20181020 更新 3.3
[新增]主菜单增加“设置>定位到当前的帮助文档”菜单
[新增]主菜单增加“添加chm文件项目”菜单
[修改]导入体积大于10MB的chm文档时，弹出确认提示，太大会花费较长的时间，且可能崩溃
[修改]快照、编辑收藏等子窗口的右下角均画上了控制窗体大小的调整控件
Windows可拖拉边框及四角调整窗体尺寸很方便，但点击拖拉的范围太小，不太容易点击操作
虽有右下角小三角调整控件，但其只在有状态栏或窗体滚动条时才可生成，所以画上一个…
20181018 更新 3.2
[修正]编辑收藏保存时会删除外部chm文件收藏的问题
[修改]为了更好的管理收藏的项目，编辑收藏时支持“多级菜单”格式
在关键字(即菜单名)前添加“组菜单名|(可多级，层级数量不限)”即可，如下例：
将某条收藏项目行文本“策略xx = ******”改为“Au3|当前学习|策略xx = ******”
此时菜单即为多级“Au3 > 当前学习 > 策略xx”，同时编辑内容也会自动按组级顺序排列
这样对于在当前程序已支持任意chm文件操作的情况下，可以更方便的组织和管理收藏项目
20181017 更新 3.1
[修改]手动检查更新时，如无更新也展示当前的版本(及提示)信息
[修改]检查更新自动下载完成后可点击提示查看文件
[修改]编辑收藏、编辑chm项目、检测更新的均可调整窗口大小(或最大化)，已更适合编辑及浏览
20181015 更新 3.0
[新增]支持任意chm文档全文搜索(特别对于学习其它语言或编程资料的帮助文档自然如虎添翼)
基本上chm的搜索功能都很弱，不说搜全，大多形同虚设，有的干脆没有搜索功能
从本版起，支持任意chm文档的全文搜索功能，只需将需要的chm文档拖入程序界面即可加入
拖入的文档采集数据后会添加到主菜单中并切换之，此时进行的搜索即会在该文档中进行
如需切换其它搜索数据只需在菜单中切换即可；返回Au3搜索可选择“AutoItCHM(默认)”菜单
另注：因任意chm内容的随意性，不可能对其进行如Au3这样固化的 函数名-解释 标题数据整理
因此对于外部chm文档无标题搜索，回车及自动搜索均为全文搜索模式，亦无需搜索结果的右键菜单
[修正]之前所有版本对于编码不统一的chm文档可能存在的乱码数据，现在增加更强的纠错能力
如发现搜索的内容列表有乱码项目(如Au3为180115版的AutoIt.chm，搜索“wm_”可能就有一段乱码列表)
遇此情况可删除当前的数据库文件(Au3目录\Au3Chm.*.dat)，让新版重新创建数据库文件
[新增]在线检测程序版本更新
点击主菜单“关于>检查更新”，如有更新版本，则提示更新内容，并可自动下载
可设置程序自动在每次启动时(后台)检查一次，在有更新版本时弹出提示
20181011 更新 2.8
[修改]SciTE查询辅助触发条件修改：仅在单击时未选择文本时触发
[新增]主菜单添加“设置>SciTE查询辅助”可选项，(窗口快捷键ctrl-b)可打开/关闭 SciTE查询辅助
[新增]SciTE 编辑器内查询助手(类似SciTE悬停显示插件，但更具人性化、实用性)
在 SciTE 编辑器中鼠标左键点击任意函数名，若该函数在帮助文档中有收录，则弹出包含说明及语法的提示
点击该提示可自动在编辑器中该行代码末端添加 “;---- 注释内容”
20181003 更新 2.7
[新增]收藏功能：对于Au3学习研究的过程中有很大的帮助，遇到感兴趣的内容可随时收藏
类似书签，但不会如书签般对系统的依赖而易造成丢失；且会自动关联到当前安装的Au3版本
当快照窗口开启时，收藏当前快照页面链接；反之收藏当前列表选择项链接页面
同一页面被重复收藏时会被阻止，并提示已保存的菜单(注：编辑收藏时允许同一页面不同菜单名)
20180930 更新 2.6
[新增]原箭头中键(左键单击粘贴搜索、右键清空输入框)按钮添加右键菜单，可直接查看、返回搜索历史
[新增]完善快照窗口功能
拉扯边框或四角可直接调整快照的窗口大小，简单且直观
添加“复制”按钮，可在界面选择文本后点击复制到剪贴板
添加“chm 中打开”按钮，可在chm文件中打开当前页，与在列表中双击打开略有区别：
列表中双击打开：
打开的是单实例，显示当前页前会关闭上一个页面；少数页面无法直接定位
点击“chm 中打开”按钮打开：
不会关闭之前打开的页面，适合同时参照；所有能在快照中显示的页面均可直接定位
在快照中点击打开的链接页也能同步在按钮中打开的地址
添加“固定位置”复选框，勾选后关闭快照后再次显示仍为之前的位置，不跟随鼠标
2.x 注册版关键更新：
[新增]全文搜索：首次使用(或版本变更)将创建数据库，通过采集全部文本数据(近百兆)，整合、过滤后生成精而全的数据库，在其中全文搜索也是毫秒级的事
[修正]一直以来引起停止响应的关键问题
[新增]上下箭头可直接在打开的快照中刷新当前选择项，大大方便浏览
[新增]其它：通篇注释工具、右键菜单记事本打开函数
本作是协助 131738 前辈修改Au3的帮助文档时用于查错的衍生工具，觉得十分方便，So稍加修改，做了这个成品。
各位可在帮助文档中或者UDF(exe档)中进行索引或搜索功能与本工具进行比对，就可以感受本工具的快感了……
搜索结果↓
快照界面↓
四大特点：1，毫秒级搜索；2，排除无关，直达真相；3，迅速、直观的结果显示；4，便捷复制需要的结果。
功能简介：
输入关键字可在Au3的帮助文档中的函数、关键字、宏、结构常量等及相关解释说明中进行实时搜索，并返回函数与解释一一对应的列表；
在列表中鼠标单击某项可打开相应的帮助文档快照（再单击一次或在快照界面右击则关闭快照；在快照界面按住左键可拖动快照）
在列表中鼠标双击可在相应的chm文档中打开并定位（相同的chm文档会在同窗口中打开）；
在列表中鼠标右击可弹出含有“函数名”及“包含头文件的函数及参数表达式”菜单，单击即可复制到剪贴板。
输入规则：
除 “@、$、*、汉字”外，其余字符均需有两个以上非空字符才会启动搜索引擎，因为是实时搜索，这样可避免无谓的搜索。
实时搜索延迟300ms才启动搜索（延时可在100-500ms之间选择），以避免字符还未输入完就已开始搜索。
补充说明：为何制作本工具？
帮助文档的搜索是全文搜索，虽然比较全，但其中的无用信息也是非常多的，所以才有了这个工具。这个是与帮助文档互补的，本工具仅搜索函数、宏、关键字等及其解释标题，这样的搜索结果其实会更有用。也能搜索到帮助文档搜索功能搜不到的内容（比如你用“单击 drag”在帮助文档的搜索功能能搜索到什么吗？有用吗？ 类似的搜索不计其数，而帮助的搜索结果经常是词不达意的东西，你还得逐一再在其中找有用的信息，可你万万想不到，找了半条命，居然还是被漏网了。。。）。
另外帮助文档的索引功能虽能即时显示结果，但它仅在首字母开始匹配。那你就需要必须记住函数的前面一些字符。同理，所以才有了这个工具。这个会使用模糊匹配。你只需记住函数名或解释说明中的某些字符即可，也不必考虑字符组的前后位置。
本工具可轻松一点查看快照，或者复制函数名，甚至包含头文件的、带参数的完整表达式。
更新历史与下载
20230307 更新 1.5.3
[新增]为 SciTE 定制的“智能F1”以查阅不同帮助文档功能
在 SciTE 编辑器中按 F1 查看帮助时只能查看于固定名为 AutoIt.chm 的文档
对于有汉化版和英文版切换阅读的需求时，一般只能互相重命名，十分繁琐不便
对此，本工具设计了一种解决方案，点击主菜单的“设置 > 智能F1功能…”
选择“添加此功能”，再选择另一个需要查阅的chm文件，应用后即可使用
该功能的作用为：
点击需要查询的关键字后，在按 F1 时，鼠标光标若在当前插入符上方则查阅另选的chm文档
反之，若在下方则查阅原文档，简直不要太方便
注：若当前关键字未在对应的文档中则始终查阅原文档
[修正]启动时判断窗口是否超出屏幕
在屏幕分辨率较大的情况下，窗口处于右下角时退出
在较小分辨率启动时，会因为超出范围而可能导致无法显示
现已修正为超出屏幕时自动变更为合适的坐标
2018.01.15 更新至 1.5.2.1 版
[修改]预支持可能新增的帮助条目
2016.01.30 更新至 1.5.1.1 版
[修正]对于 3.3.13.X 版本的 AutoIt 显示乱码的问题
2014.12.27 更新至 1.4.8 版
[新增]窗口可最大化、还原、随意拉伸调整大小并记忆退出位置
[新增]宏在快照或帮助文档中的直接定位(滚动定位仅支持较新Au3版本)
2014.02.12 更新至 1.3.8 版
[新增]支持 3.3.9.25 及以上版本的Au3。
[新增]ACN 论坛 131738 添加的 Windows Message 消息常量。
2013.04.28 更新至 1.3.4 版
[修改]优先使用 Au3Chm.exe 所在的 AutoIt 目录。
2011.11.05 更新至 1.2 版
[新增]增加使用快照的复选框，可更方便启用停用该功能。
[新增]在进退按钮中间增加了一个新按钮，该按钮在左右键点击时功能不同：
左键点击为粘贴剪贴板内容即时搜索(即使在回车搜索模式下)
右键点击为清除输入框内容，方便清除过长的内容。
2011.06.11 更新至 1.1.5 版
[修改]如果打开的快照被移动过，则在快照被关闭前不会再更随鼠标的点击。
[新增]输入“**”时将显示所有函数、关键字等列表。
[修正]关键字为空或空格时将不被保存至搜索历史。
2011.06.09 更新至 1.1.2 版
[修改]在回车搜索模式下点击回退和前进按钮时，不用回车可直接搜索。
[新增]右键菜单点击复制增加“解释”项目，方便做注释。
[新增]增加回退和前进按钮，以更方便的查看搜索历史。
2011.03.02 更新至 1.0.1 版
[修正]在任意非本工具窗口单击鼠标右键将关闭已打开的快照问题。
[修改]点击标题栏关闭按钮可选择最小化到托盘图标；同时增加托盘菜单；
2010.12.28 更新至 0.9.6 版
[修改]实时搜索时可设置延时毫秒值(右键菜单设置。另注，若是“粘贴”输入时则不延时)；
[修改]选汉功能可以在有英汉两版同在时仅选用汉化版结果(保证结果的唯一性)；
[修改]可手动选择帮助文档的路径(适合浏览存在多个版本的Au3的电脑)；
[修改]可启用快照功能(左键单击即打开快照。为不影响双击功能，此快照延迟200ms开启)；
[修改]右键复制菜单最多有3项可以直接点击复制(函数名、带参数函数表达式、含头文件的带参数函数表达式)；
2010.12.22 初发布 0.9.1 版
===================================================================
测试系统：
Win Xp Sp3、Win 7 (x86)
Win Xp、Win 7、Win 8 (x86 & x64) - Test By 131738
注意：建议搭配131738 前辈汉化的 AutoIt3 版本 使用，可获得更全、更准确、汉化更彻底的信息。其它版本或基于此但进行改编的帮助文档均有可能会显示乱码！
**** Hidden Message *****
询捕 - 巡捕。排除无关，直达真相。
https://www.autoitx.com/data/attachment/forum/202303/13/225459k33yiqqr0hg3hybr.gif
;;;;;;;;;;;;; 这个更方便了 回复 1# afan
老大,上次的正则帮助工具我是没仔细看,不好意思!我现在正要仔细看,呵呵! 我一般直接展开索引逐行往下找的，函数命名还是蛮规则，一般能猜个八九不离十。这个完全可以替代脑残的chm搜索功能。 嗯,这个东东不错啊. 有了这个，编辑就更方便啦。 本帖最后由 131738 于 2010-12-22 13:27 编辑
回复 1# afan
试了下，似乎没有在文档中直接搜索完整。。。。即使排除目录也还是太少了。。。。
本帖最后由 afan 于 2010-12-22 14:06 编辑
回复afan
试了下，似乎没有在文档中直接搜索完整。。。。
131738 发表于 2010-12-22 13:21 http://www.autoitx.com/images/common/back.gif
补充说明：为何制作本工具？
帮助文档的搜索是全文搜索，虽然比较全，但其中的无用信息也是非常多的，所以才有了这个工具。这个是与帮助文档互补的，本工具仅搜索函数、宏、关键字等及其解释标题，这样的搜索结果其实会更有用。也能搜索到帮助文档搜索功能搜不到的内容。
另外帮助文档的索引功能虽能即时显示结果，但它仅在首字母开始匹配。那你就需要必须记住函数的前面一些字符。同理，所以才有了这个工具。这个是与帮助文档互补的，它会使用模糊匹配。你只需记住函数名或解释说明中的某些字符即可。
很多情况下，我们打开帮助文档，仅是为了复制那些个虽很有印象，但又不敢保证是否完全正确的函数名，或者参数是否正确（本人就是如此），本工具因此而诞生。
帮助有的功能我这就不需要了~ 本帖最后由 afan 于 2010-12-22 14:19 编辑
回复 7# 131738
另外，本工具能搜索到的帮助文档不一定搜索得到。比如你用“单击 drag”在帮助文档的搜索功能能搜索到什么吗？有用吗？ 类似的搜索不计其数，而帮助的搜索结果经常是词不达意的东西，你还得逐一再在其中找有用的信息，可你万万想不到，找了半条命，居然还是被漏网了。。。
询捕 - 巡捕。排除无关，直达真相。 回复 9# afan
仔细对比了下，你是对的！！！ 本帖最后由 afan 于 2010-12-22 17:10 编辑
回复afan
仔细对比了下，你是对的！！！
131738 发表于 2010-12-22 15:07 http://www.autoitx.com/images/common/back.gif
另外还有个小技巧，由于帮助文档的汉化作者可能有几位，而造成用词并不统一。就算都由前辈翻译整理，也不能保证所有的用词都保证一致（汉字不适合用作编程语言的原因我想这也是其中之一），比如可能函数解释里面是“点击”，而里面的备注、参数等地方却又是“单击”。诸如此类的还有“剪切板”、“剪贴板”等… 因此，使用搜索关键词就应该注意，尽量使用它们的交集，比如“击”、“剪 板”等。 更新了一小下，修正了以下两个问题：
1，未匹配到时忘了清空之前匹配到的结果列表(如果有)
2，内存占用偏高~ 居然支持中文搜索？ 好东西，谢谢楼主。 不错啊。很实用啊。。