Решение проблемы отображения CHM HTML Help файла в Delphi XE: пошаговое руководство

Delphi , Файловая система , Help файлы

Вопрос использования CHM HTML Help файлов в приложениях на Delphi XE является актуальным для разработчиков, которые хотят интегрировать в свои проекты интерактивные руководства пользователя. В данной статье мы рассмотрим, как правильно настроить отображение CHM файлов в приложениях, написанных на Object Pascal с использованием среды Delphi XE.

Шаг 1: Подключение компонента HtmlHelpViewer

Для начала вам необходимо подключить компонент HtmlHelpViewer в один из модулей вашего проекта. Это можно сделать, добавив компонент в раздел uses соответствующего модуля.

uses
  HtmlHelpViewer;

Шаг 2: Настройка свойства Application.HelpFile

Далее, вам нужно будет указать путь к вашему CHM файлу, используя свойство Application.HelpFile. Это должно быть выполнено в обработчике события FormCreate.

procedure TForm1.FormCreate(Sender: TObject);
var
  HelpDir: string;
begin
  HelpDir := ExtractFilePath(Application.EXEName);
  Application.HelpFile := HelpDir + 'Sample.chm';
end;

Шаг 3: Удаление устаревшего кода

Убедитесь, что вы удалили все устаревшие константы, функции и код, который был описан в старой документации, таком как определения констант HH_DISPLAY_TOPIC, HH_DISPLAY_TOC, HH_CLOSE_ALL и связанные с ними функции HtmlHelp, HH.

// Удаление устаревшего кода
// ...

Шаг 4: Тестирование интеграции CHM файла

После выполнения вышеуказанных шагов, попробуйте запустить ваше приложение. При нажатии на кнопку, которая обычно вызывает помощь, должно автоматически отображаться содержимое CHM файла.

Важное примечание:

Если вы используете Delphi 5, вместо HtmlHelpViewer вам следует использовать UseHTMLHelp.

Проблемы с MDI приложениями

Если вы столкнулись с проблемами в MDI приложениях, убедитесь, что вы правильно настроили обработчик событий для отображения помощи и что CHM файл корректно связан с вашим проектом.

Работа с Unicode

Если ваше приложение использует Unicode, рекомендуется использовать функцию HtmlHelpW вместо HtmlHelpA.

Заключение

Следуя этим простым шагам, вы сможете легко интегрировать CHM HTML Help файлы в ваше приложение на Delphi XE. Удаление устаревшего кода и правильная настройка компонента HtmlHelpViewer и свойства Application.HelpFile являются ключевыми для успешной работы вашего руководства пользователя.

Мы надеемся, что эта статья помогла вам решить проблему отображения CHM HTML Help файлов в вашем приложении на Delphi. Если у вас возникнут дополнительные вопросы, не стесняйтесь обращаться за помощью к сообществу разработчиков или искать дополнительные ресурсы на официальном сайте Embarcadero.

Создано по материалам из источника по ссылке.

Приведены пошаговые инструкции по решению проблемы отображения CHM HTML Help файла в приложениях на Delphi XE.

Комментарии и вопросы

Получайте свежие новости и обновления по Object Pascal, Delphi и Lazarus прямо в свой смартфон. Подпишитесь на наш Telegram-канал delphi_kansoftware и будьте в курсе последних тенденций в разработке под Linux, Windows, Android и iOS

:: Главная :: Help файлы ::