Показ диалога Help Search 3

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

procedure TForm1.HelpSearchFor;
var
  S : String;
begin
  S := '';
  Application.HelpFile := 'C:\MYAPPPATH\MYHELP.HLP';
  Application.HelpCommand(HELP_PARTIALKEY, LongInt(@S));
end;

Протцедура HelpSearchFor! Эта процедура предназначена для поиска тем в конкретном файле справки. Вот что она делает:

1. Она инициализирует пустую строку S.
2. Она устанавливает свойство Application.HelpFile в 'C:\MYAPPPATH\MYHELP.HLP', которое specifies путь и имя файла справки, который будет поисковаться.
3. Она вызывает метод HelpCommand, передавая два параметра:
   • HELP_PARTIALKEY: это константа, представляющая тип поиска справки (в этом случае, поиск частичных ключевых слов).
   • LongInt(@S): это указатель на строку S. Оператор @ возвращает адрес памяти переменной S.

Цель вызова метода HelpCommand с этими параметрами - инициировать поиск в файле справки,指定енном в шаге 2. Поиск будет выполняться алгоритмом частичных ключевых слов, и результаты будут храниться в строке S. Однако, поскольку S является пустой строкой и не изменяется в этом процедуре, unclear, что на самом деле цели этой процедуры.

Альтернативное решение: Если вы хотите отобразить тему справки, соответствующую конкретному запросу поиска, вам может потребоваться более robust подход. Например, вы можете использовать свойство HelpContextCallback для определения callback-функции, которая будет вызвана при запросе помощи пользователем. В этой callback-функции вы можете выполнить custom-поиск и вернуть соответствующий контекст справки.

Вот пример:

type
  TMyHelpSearch = class(THelpSearch)
  public
    procedure Search(const S: String; var HelpContext: Integer);
  end;

var
  MyHelpSearch: TMyHelpSearch;

procedure TForm1.HelpSearchFor;
var
  S, HelpTopic: String;
begin
   // Установите файл и контекст справки
  Application.HelpFile := 'C:\MYAPPPATH\MYHELP.HLP';
  Application.HelpContext := 0;

   // Выполните custom-поиск с помощью MyHelpSearch
  MyHelpSearch.Search('my_search_query', HelpTopic);

   // Отобразите тему справки
  ShowMessage(HelpTopic);
end;

В этом примере TMyHelpSearch - это custom-класс, наследующийся от THelpSearch. Метод Search выполняет custom-поиск и возвращает соответствующий контекст справки как целое число. В процедуре HelpSearchFor вы можете вызвать этот метод и отобразить соответствующую тему справки с помощью функции ShowMessage.

В статье описывается процедура TForm1.HlpSearchFor, которая позволяет выполнить поиск помощи в файле help-раздела приложения, используя параметр HELP_PARTIALKEY.

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

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

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