【PB案例学习笔记】-29制作一个调用帮助文档的小功能

写在前面

这是PB案例学习笔记系列文章的第29篇，该系列文章适合具有一定PB基础的读者。

通过一个个由浅入深的编程实战案例学习，提高编程技巧，以保证小伙伴们能应付公司的各种开发需求。

文章中设计到的源码，小凡都上传到了gitee代码仓库https://gitee.com/xiezhr/pb-project-example.git

需要源代码的小伙伴们可以自行下载查看，后续文章涉及到的案例代码也都会提交到这个仓库【pb-project-example】

如果对小伙伴有所帮助，希望能给一个小星星⭐支持一下小凡。

一、小目标

通过本案例我们将制作一个点击菜单，然后调用帮助文档的小功能。这个在日常开发中是一个非常实用的小功能，我们可以将

我们开发好的程序的帮助文档制作成chm格式的文档，然后通过点击【帮助】菜单打开chm帮助文档，这可以大大提供用户体验感。

最终实现功能如下

二、创作思路

我们通过调用hhctrl.ocx库中的HtmlHelpA函数来实现其功能

hhctrl.ocx 是一个 ActiveX控件，主要用于显示 HTML 帮助文件（.chm 文件）

① 函数原型

DWORD HtmlHelpA(
  HWND hWnd,
  LPCSTR pszFile,
  UINT uCommand,
  DWORD dwData
);

② 参数说明

• hWnd: 指向窗口句柄的指针，该窗口将接收帮助对话框的 WM_HELP 消息。
• pszFile: 帮助文件的路径，通常是 .chm 文件。
• uCommand: 指定要执行的操作，如 HH_DISPLAY_TOPIC 显示特定主题，HH_DISPLAY_INDEX 显示索引等。
• dwData: 根据 uCommand 参数的不同，此参数可能包含主题 ID 或其他数据。

③ 返回值

返回值通常是一个 DWORD，其含义取决于 uCommand 参数

④ 调用示例

如果x想打开一个特定的帮助主题，你可以这样调用 HtmlHelpA：

HtmlHelpA(hWnd, "myhelpfile.chm", HH_DISPLAY_TOPIC, MAKEINTRESOURCE(IDH_MyTopic));

三、创建程序基本框架

① 创建examplework工作区

② 新建exampleapp应用

③ 新建w_main 窗口，将Title设置为"HtmlHelp调用"

由于文章篇幅原因，以上步骤不再赘述，如果忘记了的小伙伴可以翻一翻该系列文章的第一篇复习一下

四、创建菜单

① 新建菜单对象，并添加菜单项如下图所示

② 将菜单保存为m_menu

五、编写代码

① 定义全局变量，代码如下

long HH_DISPLAY_TOPIC = 0

② 定义全局扩展函数,代码如下

Function Long HtmlHelpA (long hwnd ,string lpHelpFile , long wCommand, string dwData) Library "hhctrl.ocx" 

③ 在w_main窗口中新建ue_help returns(none)函数，函数体代码如下

htmlhelpA(handle(this), "pb90.chm" + ">" + "main", HH_DISPLAY_TOPIC, "wbtargetp1.htm")

我们在根目录下准备pb90.chm文件

④ 在m_menu菜单的“帮助”菜单命名中的Clicked事件中添加如下代码

parentwindow.triggerevent("ue_help")

⑤ 在m_menu菜单的“退出”菜单命名中的Clicked事件中添加如下代码

close(w_main)

⑥ 在开发界面左边的System Tree中双击exampleapp应用，并在其Open事件中添加如下代码

open(w_main)

六、运行程序

经过一波代码编写之后，来检验下我们的劳动成果

本期内容到这儿就结束了 ★,°:.☆(￣▽￣)/$:.°★ 。希望对您有所帮助

我们下期再见ヾ(•ω•`)o (●’◡’●)