简易在线帮助对话框实现指南

在线帮助对话框是为应用程序添加帮助信息的一种快速简便的方法。对于一些应用程序来说,构建一个完整的帮助系统可能过于繁琐,而显示一些指导性信息则足以满足需求。这种对话框具有真实帮助系统的外观和感觉。

特性

在线帮助对话框具有以下特性:

  • 标准帮助窗口的外观和感觉
  • 自动调整窗口大小以适应RTF文本
  • 可调整大小
  • 如果窗口调整得过小,无法完全显示RTF文本,则自动显示滚动条
  • 通过上下文菜单复制和打印
  • 可以从资源加载RTF,或者从磁盘上的文件加载

如何将此类添加到项目中

要将此对话框包含到项目中,请按照以下步骤操作:

  1. 将HelpDialog.cpp和HelpDialog.h文件添加到项目中。
  2. 从演示项目中复制并粘贴以下帮助对话框资源到项目中:
    • IDR_POPUP_HELP_MENU菜单
    • IDD_HELP_DIALOG对话框
    • IDI_HELP_ICON图标
  3. 在项目中添加一个帮助按钮或菜单(参见示例项目)。

帮助消息的富文本格式(RTF)内容最好使用Wordpad创建。也尝试过使用Word,但有时生成的RTF格式过于复杂,无法在富文本编辑控件中使用。如果RTF过于复杂,帮助对话框将不会显示任何消息。

RTF可以通过两种不同的方法加载,第一种是将RTF文件导入项目的资源中。第二种方法是在运行时从磁盘加载RTF文件。选择最适合需求的方法。演示项目展示了这两种方法。

以下是使用RTF资源的类示例:

#include "HelpDialog.h" CSimpleHelpDemoDlg::OnHelpButton() { CHelpDialog hlp(this, IDR_HELP); // 使用RTF资源创建帮助对话框 hlp.SetTitle("简易帮助演示"); // 设置标题(可选) hlp.DoModal(); // 弹出对话框 }

以下是从磁盘文件加载帮助消息的示例代码:

#include "HelpDialog.h" CSimpleHelpDemoDlg::OnHelpButton() { CHelpDialog hlp(this); // 创建帮助对话框 hlp.SetTitle("简易帮助演示"); // 设置标题(可选) hlp.LoadRTFFile("Help2.rtf"); // 从文件加载RTF hlp.DoModal(); // 弹出对话框 }

演示项目还展示了(参见两个帮助菜单项)如何在模型无关模式下使用对话框。虽然需要更多的工作,但这是首选方法。使用模型无关的帮助对话框,用户可以在查看帮助对话框的同时切换到应用程序。使用上述示例中的模态方法,必须先关闭帮助对话框,然后才能访问应用程序窗口。

沪ICP备2024098111号-1
上海秋旦网络科技中心:上海市奉贤区金大公路8218号1幢 联系电话:17898875485