CHM帮助文档:自定义目录图标与设置方法

需积分: 35 6 下载量 97 浏览量 更新于2024-09-11 1 收藏 126KB DOC 举报
"CHM目录图标,html help自定义图标设置方法,修改hhc文件" CHM(Compiled HTML Help)文件是Microsoft开发的一种帮助文件格式,它允许开发者创建交互式的、带有索引和搜索功能的HTML帮助系统。在CHM文件中,目录结构是由一个名为.hhc(HTML Help Compiler的目录文件)的HTML文件来定义的。这个文件包含了目录项的列表,每个目录项可以关联到特定的HTML页面,并可以设置自定义图标。 当CHM文档的目录图标出现错误时,问题可能出在.hhc文件中的ImageType属性设置上。ImageType属性用于定义目录项的图标类型,它有Picture和Folder两种主要值。默认情况下,如果ImageType是Picture,且没有指定ImageNumber,那么如果有子目录,会显示“书目录”图标,否则显示“带?号的页面”图标。若ImageType是Folder,且未指定ImageNumber,有子目录则显示“文件夹目录”图标,无子目录则显示“带-号的页面”图标。 要解决图标错误,可以通过以下步骤进行: 1. 打开错误的.hhc文件,比如“KingbaseES.hhc”,通常位于项目的相应目录下。 2. 查找并分析目录项的代码段,如示例所示: `<LI><OBJECT type="text/sitemap">` `<param name="Name" value="ikill工具">` `<param name="Local" value="Admin/commandline-ikill.html">` `<param name="ImageNumber" value="11">` 3. 注意`ImageNumber`参数,它用于指定图标编号。如果希望使用默认图标,确保其值与预期图标对应的编号一致。如果需要自定义图标,需确保ImageType为Picture,并提供正确的ImageNumber。 4. 自定义图标设置:除了使用默认图标,还可以通过指定图片路径来使用自定义图标。这需要在.hhc文件中添加或修改`<param name="ImageSrc" value="path/to/icon.png">`,其中`path/to/icon.png`是图标文件的路径。 5. 保存修改后的.hhc文件,然后重新编译CHM项目以应用更改。 注意,图标文件必须是支持的位图格式(如BMP或PNG),并且应包含在CHM文件的资源中,或者在编译时可访问的同一目录下。 为了了解更多关于CHM文件的详细信息,可以参考HTML Help Compiler的规格文档,如http://www.nongnu.org/chmspec/latest/Sitemap.html#HHC_Color_Mask,该链接提供了有关目录项颜色和样式的更多细节。 通过理解这些知识点,你可以有效地调整CHM文件的目录图标,以匹配你的需求,提高帮助文档的视觉效果和用户体验。