1.8.3. Малюнок 14. Діалогове вікно для організації зв'язування файлів розділів довідки і HelpContextі у додатку. Розділи довідки, що викликаються кнопкою What's This?
Уперше такий спосіб звертання до системи оперативної довідки з'явився в операційній системі Windows 95. В екранній формі, де використовується такий метод виклику, є кнопка зі знаком питання (?) ліворуч від кнопки закриття форми в рядку заголовка. Власне виклик довідки про деякий об'єкт в екранній формі виконується в два прийоми: спочатку потрібно клацнути мишею на кнопці зі знаком питання, а потім указати на обраний об'єкт у формі і клацнути на ньому кнопкою миші. У результаті на екрані з'явиться вікно довідки про цей об'єкт. Такий спосіб виклику довідки не може бути використаний в екранній формі, що має кнопки мінімізації і максимізації вікна.
Для того щоб в екранній формі можна було викликати довідку за допомогою кнопки What's This?, потрібно попередньо виконати настроювання об'єкта форми — установити визначені значення деяких його властивостей:
WhatsThisHelp = True;
WhatsThisButton = True;
WhatsThisHelpiD = уникальное числовое значение в рамках проекта Visual FoxPro;
MinButton = False;
MaxButton = False
Налаштована в такий спосіб екранна форма у вікні Form Designer показана на Малюнок 15.
Настроювання файлу відображення.
Після настроювання властивостей об'єкта форми в середовищі Visual FoxPro можна взятися за файл відображення. У нього потрібно додати наступні директиви:
#define HIDH_GroupForm 21 // Це форма Group
#define HIDH_GroupField 22 // Це поле у формі Group
Іноді при проектуванні складної системи оперативної довідки використовується кілька файлів відображення. У цьому немає нічого страшного. Головне — усі числові значення констант у них повинні бути унікальними Неприпустиме повторення того самого значення не тільки в межах одного файлу відображення, але й у рамках усього проекту HTML Help Workshop.
Установка зв'язків.
Малюнок 15 Екранна форма Visual FoxPro, налаштована на використання довідки What's This?
Тепер настав час
указати системі, який саме розділ довідки
повинний бути зв'язаний з кожним
WhatsThіsHelpіD
Це виконується за допомогою вкладки
Alas
діалогового вікна HtmlHelp
APІ
information,
про яку йшла мова під час обговорення
методики організації контекстно-залежної
довідки. (Для виклику цього вікна варто
клацнути на піктограмі HtmlHelp
APІ information
у вкладці Project.)
Клацніть на кнопці Add,
і відкриється діалогове вікно, показане
на Малюнок 14.
У верхньому полі діалогового вікна Alіas введіть одне із символічних імен констант із файлу відображення, привласнене деякому WhatsThіsHelpID. У наступному полі введіть ім'я HTML — файлу з довідкою, що відноситься до цьому WhatsThіsHelpID. Поле Comment служить для ваших власних приміток, і його вміст ніяк не відображається в системі оперативної довідки.
Тепер можна знову виконати компіляцію проекту. У результаті наших зусиль у нього будуть включені розділи довідки, що виводяться на екран після активізації кнопки What's This? в екранній формі.