Створення файлу довідки

Реферат

На тему: Створення файлу довідки

Після того, як довідкова інформація буде підготовлена, можна приступити до безпосереднього створення довідкової системи.

Спочатку треба запустити HTML Help Workshop, з меню File вибрати команду New | Project і у вікні New Project задати ім'я файлу проекту створюваної довідкової системи (мал. 8.20). Після клацання на кнопці Далі в цьому і наступному вікнах вікно HTML Help Workshop.

Перше, що треба зробити, - це сформувати розділ [FILES], який повинен містити імена HTML-файлов, в яких знаходиться довідкова інформація. Щоб додати в розділ [FILES] ім'я файлу, треба клацнути на кнопці Add/remove topic files а потім в діалоговому вікні, що з'явилося Topic Files (мал. 8.22) -- на кнопці Addпісля чого в стандартному діалоговому вікні, що з'явилося, Відкрити вибрати HTML-файл розділу довідки. Якщо довідкова інформація розподілена по декількох файлах, то операцію додавання потрібно повторити кілька разів. Після того, як в діалоговому вікні Topic Files будуть перераховані всі необхідні для створення довідкової інформації HTML-файлы, потрібно клацнути на кнопці ОК. В результаті цих дій у файлі проекту з'явиться розділ [FILES], у якому будуть перераховані HTML-файлы, використовувані для створення довідкової системи.

Наступне, що треба зробити, -- це задати головний (стартовий) розділ і заголовок вікна довідкової системи. Заголовок і ім'я файлу головного розділу вводяться відповідно в поля Title і Default file вкладки General діалотового вікна Options яке з'являється в результаті клацання на кнопці Change project options.

У розділі [FILES] перераховані файли, використовувані для створення chm-файла.

Якщо для навігації по довідковій системі передбачається використовувати вкладку Зміст, то треба створити файл контексту. Щоб це зробити, потрібно клацнути на вкладці Contents підтвердити створення нового файлу і задати ім'я файлу контексту, як який можна використовувати ім'я проекту. В результаті стане доступною вкладка Contents, в яку потрібно ввести зміст -- назви розділів довідкової системи.

Зміст довідкової системи прийнято зображати у вигляді ієрархічного списку. Елементи верхнього рівня відповідають розділам, а підлеглі ним елементи -- підрозділам і темам.

Щоб у вкладку Contents додати елемент, відповідний розділу довідкової системи, потрібно клацнути на кнопці Insert а heading у полі Entry title діалогового вікна, що з'явилося Table of Contents Entry ввести назву розділу і клацнути на кнопці Add. На екрані з'явиться вікно Path or URL. У полі HTML titles цього вікна будуть перераховані назви розділів (заголовки HTML-файлов) довідкової інформації, яка знаходиться у включених в проект файлах (імена цих файлів вказані в розділі [FILES] вкладки Project). Якщо замість назви розділу буде вказано ім'я файлу, це означає, що у відповідному файлі немає тега <TITLE>. Вибравши розділ, треба клацнути на кнопці ОК. В результаті перерахованих вище дій у вкладці Contents з'явиться рядок з назвою розділу довідкової інформації.

При необхідності змінити значок, відповідний доданому розділу, слід клацнути на кнопці Edit selection і, використовуючи список Image index вкладки Advanced вікна Table of Contents вибрати потрібний значок (зазвичай поряд з назвою розділу або підрозділу зображена книжка).

Підрозділ додається точно так, як і розділ, з тим тільки відмінністю, що після того, як підрозділ буде доданий, потрібно клацнути на кнопці Move selection right. Внаслідок чого рівень заголовка знизиться, тобто розділ стане підрозділом.

Елементи зміст, відповідний темам довідкової інформації, додається аналогічним чином, але процес починається клацанням на кнопці Insert а page.

Іноді виникає необхідність змінити порядок проходження елементів списку змісту або рівень ієрархії елементу списку. Зробити це можна за допомогою командних кнопок, на яких зображені стрілки. Кнопки Move selection up і Move selection down переміщають виділений елемент списку, відповідно, вгору і вниз. Кнопка Move selection right переміщає виділений елемент управо, тобто робить його підлеглим попередньому елементу списку. Кнопка Move selection left виводить елемент з підлеглості попередньому елементу.

Компіляція

Після того, як будуть визначені файли, в яких знаходиться довідкова інформація (сформований розділ [FILES]) і підготовлена інформація для формування вкладки Зміст (створений файл контексту), можна виконати компіляцію -- перетворити початкову довідкову інформацію у файл довідкової системи (chm-файл).

Початковою інформацією для HTML Help компілятора є:

файл проекту (hhp-файл);

файл контексту (hhc);

файли довідкової інформації (htm-файлы);

файли ілюстрацій (gif- і jpg-файлы).

Результатом компіляції є файл довідкової системи (chm-файл).

Щоб виконати компіляцію, треба в меню File вибрати команду Compileу діалоговому вікні, що з'явилося Create а compiled file (мал. 8.29) встановити перемикач Automatically display compiled help file when done (після компіляції показати створений файл довідки) і клацнути на кнопці Compile. В результаті цього буде створений файл довідки і на екрані з'явиться вікно довідкової системи, в якому буде виведена інформація головного розділу.

Виведення довідкової інформації

вкладка компіляція довідкова файл

Вивести довідкову інформацію, яка знаходиться в chm-файле, можна декількома способами. Найпростіше це зробити за допомогою утиліти hh.exe складовою частиною Windows, що є. Викликати утиліту відображення довідкової інформації і передати їй як параметр ім'я файлу довідкової системи можна за допомогою функції winexec. У функції winexec два параметри. Перший -- ім'я виконуваного файлу програми, яку треба запустити, і командний рядок. Другий параметр визначає спосіб відображення вікна програми, що запускається. Вікно програми, що запускається, може бути розгорнене на звістку екран (Sw_maximize), запущена програма може працювати в згорнутому вікні (Sw_minimize) або вікно програми може мати розмір і положення такі, якими вони були в попередньому сеансі роботи (Sw_restore ). Нижче як приклад приведена функція обробки події click на кнопці Довідка. Функція забезпечує виведення довідкової інформації, яка знаходиться у файлі saper.chm.

// Клацання на кнопці Довідка

void __fastoall Tforml::button2click(Tobject *Sender)

{

Winexec("hh saper.chm",SW_RESTORE); }

Размещено на Allbest.ru