返回列表 发帖

[原创] Au3Chm 函数询捕 (帮助文档辅助)_1.5.1.1

本帖最后由 afan 于 2016-3-15 12:59 编辑


2016.01.30 更新至 1.5.1.1 版
        [修正]修正长时间运行时可能会闪退的问题


最近协助 131738 前辈修改Au3的帮助文档时用于查错的衍生工具,觉得十分方便,So稍加修改,做了这个成品。
各位可在帮助文档中或者UDF(exe档)中进行索引或搜索功能与本工具进行比对,就可以感受本工具的快感了……

界面↓


搜索结果↓


快照界面↓


四大特点:1,毫秒级搜索;2,排除无关,直达真相;3,迅速、直观的结果显示;4,便捷复制需要的结果。

功能简介:
输入关键字可在Au3的帮助文档中的函数、关键字、宏、结构常量等及相关解释说明中进行实时搜索,并返回函数与解释一一对应的列表;
无需其它数据库之类支持,前提是你必须安装了AutoIt3(废话,没安装也不会需要这);
在列表中鼠标单击某项可打开相应的帮助文档快照(再单击一次或在快照界面右击则关闭快照;在快照界面按住左键可拖动快照)
在列表中鼠标双击可在相应的chm文档中打开并定位(相同的chm文档会在同窗口中打开);
在列表中鼠标右击可弹出含有“函数名”及“包含头文件的函数及参数表达式”菜单,单击即可复制到剪贴板。

输入规则:
除 “@、$、*、汉字”外,其余字符均需有两个以上非空字符才会启动搜索引擎,因为是实时搜索,这样可避免无谓的搜索。
实时搜索延迟300ms才启动搜索(延时可在100-500ms之间选择),以避免字符还未输入完就已开始搜索。

补充说明:为何制作本工具?
        帮助文档的搜索是全文搜索,虽然比较全,但其中的无用信息也是非常多的,所以才有了这个工具。这个是与帮助文档互补的,本工具仅搜索函数、宏、关键字等及其解释标题,这样的搜索结果其实会更有用。也能搜索到帮助文档搜索功能搜不到的内容(比如你用“单击 drag”在帮助文档的搜索功能能搜索到什么吗?有用吗? 类似的搜索不计其数,而帮助的搜索结果经常是词不达意的东西,你还得逐一再在其中找有用的信息,可你万万想不到,找了半条命,居然还是被漏网了。。。)。
        另外帮助文档的索引功能虽能即时显示结果,但它仅在首字母开始匹配。那你就需要必须记住函数的前面一些字符。同理,所以才有了这个工具。这个会使用模糊匹配。你只需记住函数名或解释说明中的某些字符即可,也不必考虑字符组的前后位置。
        本工具可轻松一点查看快照,或者复制函数名,甚至包含头文件的、带参数的完整表达式。

更新历史与下载


2016.01.30 更新至 1.5.1.1 版
        [修正]修正长时间运行时可能会闪退的问题

2016.01.13 更新至 1.5.1 版
        [修正]修正长时间运行时可能会闪退的问题

2015.01.23 更新至 1.5 版
        [修正]对于 3.3.13.X 版本的 AutoIt 显示乱码的问题

2014.12.27 更新至 1.4.8 版
        [新增]窗口可最大化、还原、随意拉伸调整大小并记忆退出位置
        [新增]快捷方式“Ctrl-T”窗口“置顶/取消”

        [新增]另附上以下测试功能,但测试阶段禁用:
           ◇后台监视功能(其它编辑工具如记事本或SciTE的鼠标双击动作)。
              如监视到双击选中的内容中含有帮助文档中匹配的函数名,会在鼠标附近出现函数解释,并将:
                        在需要注释的地方点击鼠标右键可粘贴函数解释;
                        保存这些函数名于“监视”复选框的右键菜单(15条内),可即刻(或准备)查看详细的帮助
           ◇在列表中鼠标右键菜单增加一项“查看函数源码 → Udf 文档”的功能,点击可直接在记事本中定位到该文件的该函数定义处。
           ◇增加AutoIt附带的chm档中没有的提取自ACN 论坛 Netegg 所著的 autoit3udf.exe 的千余条函数名及其解释。
              可搜索或复制函数名及解释(不含表达式及头文件),支持双击在“autoit3udf.exe”中打开并模拟定位。
              (需自行下载所需的 autoit3udf.exe,并置于指定目录或指定其目录)
           ◇增加通篇注释功能,可在au3脚本的含有匹配函数名的行末端增加函数注释。
              为了便于阅读,不会对嵌套函数添加注释(仅注释最外围的函数,如有需要可通过监视功能再自行进行注释);
              连续的同函数名行仅注释第一行;注释过(含有相同注释内容)的将不会重复注释。

2014.12.25 更新至 1.4 版
        [新增]宏在快照或帮助文档中的直接定位(滚动定位仅支持较新Au3版本)
        [新增]AutoItSetOption 中的关键字及在快照或帮助文档中的直接定位(滚动定位仅支持较新Au3版本)
           至此,以AutoIt3 v3.3.10.0 版为例,可搜索的英+汉数据库总量已达到7500组。

2014.02.12 更新至 1.3.8 版
        [新增]支持 3.3.9.25 及以上版本的Au3。
           对单CHM文件的AutoIt3版本支持以及支持自行添加并按以下规则重命名的文件:
           AutoIt.chm 单文件
           AutoIt.chm + AutoItCHS.chm (英文原版+汉化版)
           AutoIt.chm + AutoItENG.chm (汉化版改名为AutoIt.chm + 英文原版)
           AutoIt.chm + AutoIt_EN.chm (汉化版改名为AutoIt.chm + 英文原版)
           之前版本的函数询捕在3.3.9.25 及以上版本的Au3环境使用时会错误提示"4",因这些版本仅有一个chm文档,文件目录结构已发生较大改变。
           为了继续保持向上支持,本次版本做了较大修改。
        [新增]ACN 论坛 131738 添加的 Windows Message 消息常量。

2013.04.28 更新至 1.3.4 版
        [修正]剪贴板没有一个非空字符将不再搜索。

2013.04.25 更新至 1.3.3 版
        [修正]自测发现可能存在的问题。

2013.04.15 更新至 1.3.2 版
        [修正]自测发现可能存在的问题。

2013.04.13 更新至 1.3.1 版
        [修正]在菜单中选择实时搜索延时时出现的变量错误。

2013.03.10 更新至 1.3 版
        [修改]优先使用 Au3Chm.exe 所在的 AutoIt 目录。
                这意味着如果存在多个版本的 AutoIt,可以复制 Au3Chm 到其目录下,方便直接使用该版本的 chm 文件。
        [新增]对x64操作系统的支持。解决在x64操作系统下提示“未找到 AutoIt.chm 帮助文档...”的问题。

2011.11.05 更新至 1.2 版
        [修改]将不常用的实时/回车搜索单选框移入了主菜单。
        [新增]增加使用快照的复选框,可更方便启用停用该功能。
        [新增]在进退按钮中间增加了一个新按钮,该按钮在左右键点击时功能不同:
                左键点击为粘贴剪贴板内容即时搜索(即使在回车搜索模式下)
                右键点击为清除输入框内容,方便清除过长的内容。

2011.11.04 更新至 1.1.6 版
        [修正]在使用一段时间后报数组错误,原因是保存的关键字历史超出。
        [修正]置顶与取消的细微迟疑。

2011.06.11 更新至 1.1.5 版
        [修改]如果打开的快照被移动过,则在快照被关闭前不会再更随鼠标的点击。
2011.06.10 更新至 1.1.4 版
        [新增]输入“**”时将显示所有函数、关键字等列表。
        [修改]相同的关键字只保留一次搜索历史。
2011.06.10 更新至 1.1.3 版
        [修正]在菜单中执行“指定帮助文档目录”后点击取消,快照将无法显示内容。
        [修正]关键字为空或空格时将不被保存至搜索历史。

2011.06.09 更新至 1.1.2 版
        [修改]在回车搜索模式下点击回退和前进按钮时,不用回车可直接搜索。
        [修改]在实时搜索模式输入时,以未继续输入的停留时间超过2秒才进行保存关键字,以避免保存分段过细的关键字历史。
2011.06.09 更新至 1.1.1 版
        [新增]右键菜单点击复制增加“解释”项目,方便做注释。
        [新增]增加回退和前进按钮,以更方便的查看搜索历史。

2011.03.02 更新至 1.0.1 版
        [修正]在任意非本工具窗口单击鼠标右键将关闭已打开的快照问题。
        [修正]重复运行本工具时,如已经运行了一个打开了快照界面并且为最小化到托盘图标状态时,窗口会显示出来,
              但托盘图标仍存在,关闭窗口时,快照仍显示的问题。

2011.03.01 更新至 1.0.0 版
        [修正]未获取到帮助文档数据时仍可输入字符的无意义问题;
        [修改]设置快照尺寸在快照已显示时也会即时调整到设置尺寸;
        [修正]点击右键菜单复制时可能会失效的问题;
        [修改]点击标题栏关闭按钮可选择最小化到托盘图标;同时增加托盘菜单;
另,原本准备加入划词搜索功能,不过感觉使用需求会很少,故没有加上。

2011.01.24 更新至 0.9.8 版
        [修正]回车热键独占的问题;
        [修改]增加快照界面可自行设置宽度及高度。

2010.12.28 更新至 0.9.6 版
        [修改]实时搜索时可设置延时毫秒值(右键菜单设置。另注,若是“粘贴”输入时则不延时);
        [修改]选汉功能可以在有英汉两版同在时仅选用汉化版结果(保证结果的唯一性);
        [修改]可手动选择帮助文档的路径(适合浏览存在多个版本的Au3的电脑);
        [修改]可启用快照功能(左键单击即打开快照。为不影响双击功能,此快照延迟200ms开启);
        [修改]右键复制菜单最多有3项可以直接点击复制(函数名、带参数函数表达式、含头文件的带参数函数表达式);
        [修改]所有的设置改变均自动保存,方便下次使用习惯设置。

2010.12.22 初发布 0.9.1 版

===================================================================


支持Au3 3.3.3.1 及以上版本,更低的版本我这没有,不好测试修补,也不想因此影响整个工具的效率(因为早期的chm内置文件编码很不规范)。

测试系统:
Win Xp Sp3、Win 7 (x86)
Win Xp、Win 7、Win 8 (x86 & x64) - Test By 131738

 
建议搭配使用 新版 AutoIt3 ,可获得更全、更准确、汉化更彻底的信息。



询捕 - 巡捕。排除无关,直达真相。
 
附件: 您需要登录才可以下载或查看附件。没有帐号?加入
13

评分人数

  • zpmc123

  • iamwonvy

  • maker

  • annybaby

  • 流浪的灵魂

请勿私信提问,有问题请发帖。

这个更方便了
1

评分人数

  • afan

自己知道的,尽量告诉别人,自己不知道的,虚心学习

TOP

回复 1# afan
老大,上次的正则帮助工具我是没仔细看,不好意思!我现在正要仔细看,呵呵!
1

评分人数

  • afan

TOP

我一般直接展开索引逐行往下找的,函数命名还是蛮规则,一般能猜个八九不离十。这个完全可以替代脑残的chm搜索功能。
1

评分人数

  • afan

TOP

嗯,这个东东不错啊.
1

评分人数

  • afan

研究研究

TOP

有了这个,编辑就更方便啦。
1

评分人数

  • afan

TOP

本帖最后由 131738 于 2010-12-22 13:27 编辑

回复 1# afan

试了下,似乎没有在文档中直接搜索完整。。。。即使排除目录也还是太少了。。。。
附件: 您需要登录才可以下载或查看附件。没有帐号?加入
1

评分人数

  • afan

TOP

本帖最后由 afan 于 2010-12-22 14:06 编辑
回复  afan

试了下,似乎没有在文档中直接搜索完整。。。。
131738 发表于 2010-12-22 13:21

补充说明:为何制作本工具?
        帮助文档的搜索是全文搜索,虽然比较全,但其中的无用信息也是非常多的,所以才有了这个工具。这个是与帮助文档互补的,本工具仅搜索函数、宏、关键字等及其解释标题,这样的搜索结果其实会更有用。也能搜索到帮助文档搜索功能搜不到的内容。
        另外帮助文档的索引功能虽能即时显示结果,但它仅在首字母开始匹配。那你就需要必须记住函数的前面一些字符。同理,所以才有了这个工具。这个是与帮助文档互补的,它会使用模糊匹配。你只需记住函数名或解释说明中的某些字符即可。
        很多情况下,我们打开帮助文档,仅是为了复制那些个虽很有印象,但又不敢保证是否完全正确的函数名,或者参数是否正确(本人就是如此),本工具因此而诞生。
帮助有的功能我这就不需要了~

TOP

本帖最后由 afan 于 2010-12-22 14:19 编辑

回复 7# 131738


    另外,本工具能搜索到的帮助文档不一定搜索得到。比如你用“单击 drag”在帮助文档的搜索功能能搜索到什么吗?有用吗? 类似的搜索不计其数,而帮助的搜索结果经常是词不达意的东西,你还得逐一再在其中找有用的信息,可你万万想不到,找了半条命,居然还是被漏网了。。。

询捕 - 巡捕。排除无关,直达真相。

TOP

回复 9# afan

仔细对比了下,你是对的!!!

TOP

本帖最后由 afan 于 2010-12-22 17:10 编辑
回复  afan

仔细对比了下,你是对的!!!
131738 发表于 2010-12-22 15:07



    另外还有个小技巧,由于帮助文档的汉化作者可能有几位,而造成用词并不统一。就算都由前辈翻译整理,也不能保证所有的用词都保证一致(汉字不适合用作编程语言的原因我想这也是其中之一),比如可能函数解释里面是“点击”,而里面的备注、参数等地方却又是“单击”。诸如此类的还有“剪切板”、“剪贴板”等… 因此,使用搜索关键词就应该注意,尽量使用它们的交集,比如“击”、“剪 板”等。
附件: 您需要登录才可以下载或查看附件。没有帐号?加入

TOP

更新了一小下,修正了以下两个问题:
1,未匹配到时忘了清空之前匹配到的结果列表(如果有)
2,内存占用偏高~
请勿私信提问,有问题请发帖。

TOP

居然支持中文搜索?

TOP

好东西,谢谢楼主。
1

评分人数

  • afan

TOP

不错啊。很实用啊。。
1

评分人数

  • afan

TOP

返回列表