Кент Рейсдорф. BORLAND C++BUILDER. Страница 400

Опубликовано 05.05.11

Как минимум, вы должны обеспечить контекстную справку для каждой формы своего приложения (диалоговых или вторичных окон). В конечном счете, вам решать, для каких компонентов приложения предоставлять кон­текстную справку. Но если вы и ошибетесь, то это должна быть ошибка в сторону избытка справочной информации (если такое вообще возможно), а не наоборот.

Реализация контекстно-зависимой справки

Контекстно-зависимая справка относительно просто реализуется в при­ложениях C++Builder. Как я уже говорил, основная работа состоит в напи­сании справочного файла. Все остальное по сравнению с этим — детские забавы.

Настройка справочного файла

Независимо от того, как вы реализуете контекстную справку, сначала вы должны сообщить Windows имя справочного файла приложения. Для этого нужно присвоить имя справочного файла свойству HelpFile класса Ap­plication. Вы можете сделать это двумя способами. Самый простой способ реализуется на этапе разработки через диалоговое окно Project Options. В 10-й день, «Подробнее о проектах», мы рассмотрели опции проекта. Я обратил ваше внимание на то, что вкладка Application диалогового окна Project Op­tions имеет поле Help File, в котором задается имя справочного файла при­ложения. Просто введите в это поле имя вашего справочного файла, a VCL присвоит его свойству HelpFile. После этого ваше приложение будет исполь­зовать указанное имя при каждом запросе справки.

Вы можете также задать имя справочного файла во время выполнения программы. Это может потребоваться в том случае, если вы даете пользова­телям возможность поместить справочный файл в любой каталог по их вы­бору. Вы можете сохранить путь к справочному файлу в реестре Windows (реестр рассматривается позже, в разделе «Работа с реестром»), а затем при­своить его вместе с именем файла свойству HelpFile объекта Application. Например, часть вашего обработчика события OnCreate могла бы выглядеть следующим образом: