|
О файлах карты |
    |
|
О файлах карты |
|
Компиляторы для многих современных языков программирования имеют средства для того, чтобы автоматически генерировать специальные текстовые файлы, называемые "файлы карты", содержащие ID раздела и/или числа справочного контекста для компонентов и управлений, используемых в программе. Эти файлы могут сохранить Вам много работы в Help & Manual.
Генерация недостающих разделов и контекстных чисел:
Help & Manual может использовать эти файлы и чтобы назначить недостающие числа справочного контекста на существующие разделы, и чтобы автоматически генерировать недостающие разделы с ID раздела и числами справочного контекста. Эта двойная возможность особенно полезна, чтобы генерировать контекстно-зависимые всплывающие разделы, используемые, чтобы документировать управления компонентов программы и управления с функцией Что это? и другими подобными функциями. См. Автогенерация контекстно-зависимого всплывания и Инструмент контекста справки для деталей.
Синтаксис файла карты:
Эти файлы имеют очень простой синтаксис. Каждая строка просто содержит команду #define, сопровождаемую ID раздела и числом справочного контекста.
Пример:
#define
IDH_DEFAULT 100001
#define IDH_OK_BTN 100002
#define IDH_CANCEL_BTN
100003
#define IDH_CLOSE 100004
#define IDH_HELP_BTN
100005
#define IDH_APPLY_BTN
100006
#define IDH_APP_HMB
100010
#define IDH_WHAT_IS_THIS_CMD
100011
#define IDH_WHAT_IS_THIS_POPUP
100012
Ограничения файлов карты:
Использование файла карты, чтобы применить числа справочного контекста к существующим разделам, является очень простым. Однако, есть два основных ограничения, когда Вы используете файлы карты, чтобы генерировать разделы, которые еще не существуют в вашем проекте справки:
Вы не можете генерировать заголовки раздела
Так как синтаксис файла карты включает только ID раздела и число справочного контекста, Вы не можете включить заголовки (то есть имена разделов в Содержании) для разделов в файле карты, и Вы не можете использовать файл карты, чтобы генерировать заголовки. Все разделы, сгенерированные из файлов карты, используют ID раздела как заголовок.
Вы можете генерировать разделы только в секции Невидимые разделы
Это второе ограничение следует из первого. Так как автосгенерированные разделы не могут иметь реальных заголовков, они всегда генерируются в секции Невидимые разделы и определяются как всплывающие разделы в их вкладках Опции раздела (по умолчанию для разделов в этой секции).
Это - вообще не проблема, так как первичная цель этой функции состоит в том, чтобы автогенерировать контекстно-зависимые всплывающие разделы для того, чтобы документировать компоненты программы.
Если Вы должны использовать функцию, чтобы генерировать разделы в Содержании, Вы должны перетащить их в Содержание мышью после их генерации и редактировать их заголовки вручную.
См. также: