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

С ОКНОМ OpenHelp. :»

Содержание справочной службы оформляется в файле с расширением CNT и становится доступным на вкладке Содержание в справочном окне Delphi. Для создания/редактирования содержания используется утилита MS HW.

Чтобы создать файл содержания, запустите утилиту MS HW, выберите команду File ► New, затем - команду Help Contents, и на экране появится окно, изображенное на рис. 10.13.

В полях Default filename (and window) и Default title в верхней части окна нужно указать соответственно имя НLP-файла, для которого создается содержание, и тип окна для отображения оглавлений, а также заголовок основного окна справочной службы. Именно этот заголовок идентифицирует справку в окне OpenHelp.

Элементы содержания могут быть темами и разделами. Темы служат узлами в иерархической структуре содержания. В окне справочной службы слева от названия темы указывается значок в виде раскрытой или захлопнутой книги.

Раздел - конечный элемент содержания. Слева от него указывается значок в виде страницы с вопросительным знаком.

Для вставки в файл элемента содержания нужно щелкнуть на кнопке Add Above или Add Below. В первом случае элемент вставляется перед текущим элементом, во втором - после него. После щелчка на любой из этих кнопок появляется окно, показанное на рис. 10.15.

10.3.5. Файл содержания справочной службы

Рис. 10.15. Окно определения элемента оглавления

Переключатели в верхней части окна определяют тип вставляемого элемента:

• Heading - вставляется тема; при выборе этого переключателя все расположенные ниже строки, исключая Title, становятся недоступными;
• Topic - вставляется раздел;
• Macro - вставляется макрокоманда, которая будет выполнена при выборе элемента в окне содержания;

• Include - вставляется текстовый ASCII-файл с элементами содержания.

Четыре поля ниже переключателей используются только при вставке раздела. При вставке темы или включаемого файла доступно только первое поле, при вставке макрокоманды - первое и второе, которое в этом случае снабжается надписью Macro.

В поле Title вводится произвольный текст длиной до 127 символов, который будет представлять элемент в окне содержания. В этой строке также указывается имя включаемого файла, если установлен переключатель Include. Во втором поле указывается идентификатор раздела или имя макрокоманды. В поле Help file нужно указать HLP-файл, а в строке Window type - тип окна для отображения раздела.

Для смещения элемента оглавления на один уровень иерархии вниз используется кнопка Move Right, а на один уровень вверх - кнопка Move Left. Элемент сдвигается вместе со всеми другими элементами, расположенными ниже него. Максимальное количество уровней иерархии - 9.

Следует заметить, что файл содержания представляет собой текстовый ASCII-файл, каждая строка которого соответствует элементу содержания. В начале строки указывается цифра, определяющая уровень иерархии, на котором располагается элемент. На рис. 10.16 для примера показано содержание справочной службы Component Writer's Guide (файл $(DELPHI)\Help\d7cw.hlp).

10.3.5. Файл содержания справочной службы

Рис. 10.16. Окно содержания справочной службы

Далее представлен фрагмент CNT-файла, соответствующий показанному на рисунке окну содержания:

:Base d7cw.hlp>main

:Title Creating Custom Components

1 Component Writer's Guide

2 Introduction to component creation

3 Overview of component creation = cwgoverviewofcomponentcreation 3 Class library - cwgthevisualcomponentlibrary

3 Components and classes « cwgcomponentsandobjects

3 Creating components - cwgwhatkindsofcomponentscanyoucreate

3 Modifying existing controls - cwgcustomcontrols

3 Creating original controls = cwgwindowedcontrols 3 Creating graphic controls = cwggraphicalcontrols

После создания файла содержания его нужно сохранить в том же каталоге, что и HLP-файл.

10.3.4. Создание и компиляция файла проекта || Оглавление || 10.3.6. Регистрация справки в справочной системе Delphi


Искусство создания компонентов Delphi



Новости за месяц

  • Июнь
    2019
  • Пн
  • Вт
  • Ср
  • Чт
  • Пт
  • Сб
  • Вс