Использование справки HTML Help

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

Автор: Oleg Gashev
WEB-сайт: http://delphibase.endimus.com

{ **** UBPFD *********** by delphibase.endimus.com ****
>> Использование справки HTML Help

Зависимости: hhctrl.ocx
Автор:       Oleg Gashev, oleg@gashev.com, ICQ:115695048, Israel, Rehowot
Copyright:   http://gashev.com
Дата:        04 мая 2002 г.
***************************************************** }

unit uHtmlHelp;

interface
uses Windows;
function HtmlHelpA(hwndCaller: HWND; pszFile: PAnsiChar;
  uCommand: UInt; dwData: DWORD): HWND; stdcall; external 'hhctrl.ocx';

implementation

end.

unit SDIMAIN;
// Main Window
interface

uses........., uHtmlHelp, .....;

const
  HH_CLOSE_ALL = $0012;

  ......
  ......

function TSDIAppForm.FormHelp(Command: Word; Data: Integer;
  var CallHelp: Boolean): Boolean;
begin
  HtmlHelpA(handle, PChar(m_HelpFile), 15, Data);
  CallHelp := true;
end;

procedure TSDIAppForm.FormClose(Sender: TObject;
  var Action: TCloseAction);
begin
  ...........
  HtmlHelpA(handle, PChar(m_HelpFile), HH_CLOSE_ALL, 0);
end;

end.

Это код на языке программирования Delphi, который реализует систему HTML-справки (HTML Help). Код состоит из двух модулей: uHtmlHelp и SDIMAIN.

Модуль uHtmlHelp объявляет функцию HtmlHelpA, которая является интерфейсом к контролу HTML Help (hhctrl.ocx). Функция принимает четыре параметра:

• hwndCaller: Обратный handle окна, которое вызвало функцию HtmlHelp.
• pszFile: Указатель на имя файла справки.
• uCommand: Неотрицательное целое значение, которое specifies the command to be executed.
• dwData: DWORD-значение, содержащее дополнительные данные для команды.

Модуль SDIMAIN является основной формой окна, которая использует функцию HtmlHelpA. Он имеет две функции:

1. FormHelp: Функция вызывается, когда пользователь запрашивает справку из приложения. Она вызывает функцию HtmlHelpA с handle основного окна, именем файла справки и командой открытия файла справки.
2. FormClose: Функция вызывается, когда пользователь закрывает основное окно. Она вызывает функцию HtmlHelpA с handle основного окна, именем файла справки и командой закрытия всех окон справки.

Код также определяет константу HH_CLOSE_ALL, которая specifies the command to close all help windows.

Процедура TSDIAppForm.FormHelp вызывается, когда пользователь запрашивает справку из приложения. Она вызывает функцию HtmlHelpA с handle основного окна, именем файла справки и командой открытия файла справки. Параметр CallHelp установлен в true, что означает, что система справки будет вызвана снова, если пользователь запрашивает справку.

Процедура TSDIAppForm.FormClose вызывается, когда пользователь закрывает основное окно. Она вызывает функцию HtmlHelpA с handle основного окна, именем файла справки и командой закрытия всех окон справки.

В целом, этот код реализует систему HTML-справки в Delphi, позволяя пользователям доступ к файлам справки из приложения.

В статье описывается использование справки HTML Help в программировании на языке Delphi, в частности, демонстрируются примеры кода для вызова и закрытия справки с помощью компонента hhctrl.ocx.

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

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

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