Использование справочной системы в приложениях. Команды Visual FoxPro для управления справочной системой.
Мы рассмотрели создание справочных систем двух типов. Однако обращение к ним из приложения, созданного в Visual FoxPro, осуществляется одинаково. Рассмотрим в данном разделе команды Visual FoxPro, управляющие выводом справочной информации, и свойства элементов управления, с помощью которых организуется связь с темами справочной системы.
Для определения файла, содержащего справочную систему, а также для вывода на экран содержания или указанной темы из справочной системы используются команды Visual FoxPro. Список этих команд и их назначение приведены в табл. 12.7.
Таблица 12.7. Назначение команд для управления справочной системой.
| Команда | Назначение |
|---|---|
| SET HELP | Запрещает или разрешает вывод справочной системы или определяет имя используемой справочной системы |
| HELP | Выводит на экран содержание или указанную тему справочной системы |
| SET TOPIC TO | Определяет содержание справочной системы |
SET HELP
Команда SET HELP управляет выводом справочной системы и определяет ее имя. Она имеет два варианта синтаксиса:
| Команда | Назначение |
|---|---|
| SET HELP ON | OFF | Предназначена для разрешения или запрета активизации стандартной справочной системы программы Visual FoxPro. Если использована команда SET HELP ON, при нажатии клавиши F1 или при выполнении команды HELP основного меню отображается стандартная справочная система Visual FoxPro. При использовании команды SET HELP OFF средства просмотра справочной системы будут недоступны |
| SET HELP TO имяФайла | Определяет дополнительный файл справочной системы. Этот вариант команды позволяет использовать созданную вами справочную систему |
Например:
SET HELP TO sales.hip
HELP
Для вывода на экран содержания справочной системы или указанной темы в окне справочной системы предназначена команда HELP, имеющая следующий синтаксис:
HELP [идентификаторТемы | ID индексТемы] [IN [WINDOW] имяОкна I IN [WINDOW] SCREEN] /" I IN [WINDOW] MACDESKTOP] [NOWAIT]
Для вывода содержания справочной системы необходимо использовать команду HELP без указания имени темы. Если вы хотите отобразить контекстную справку, необходимо указать идентификатор темы или ее индекс.
Опция IN [WINDOW] позволяет открыть окно справочной системы внутри окна, описанного с помощью команды DEFINE WINDOW.
По умолчанию при вызове справочной системы приостанавливается выполнение программы, позволяя пользователю найти требуемую информацию. При использовании опции NOWAIT после вывода справочной информации программа продолжает свое выполнение.
SET TOPIC
По умолчанию содержанием справочной системы является первая по порядку тема. Для изменения содержания используется команда SET TOPIC, позволяющая определить тему, которая в дальнейшем будет являться содержанием справочной системы.
Команда имеет два варианта синтаксиса:
SET TOPIC ТО [имяТемы | логическоеВыражение]
SET TOPIC ID TO [индексТемы]
Используя команду SET TOPIC то имяТемы, вы можете задать имя темы, отображаемой в справочной системе.
Команда SET TOPIC то логическоеВыражение отображает заданную тему в справочной системе в зависимости от значения логического выражения.
Команда SET TOPIC ID то [индексТемы] используется для указания отображаемой темы по его идентификатору.