Навигация:  Справочная информация > Контекстно-зависимая справка и всплывание >

О файлах карты

Печать этого раздела Предыдущая страницаВернуться к краткому обзору главыСледующая страница

Компиляторы для многих современных языков программирования имеют средства для того, чтобы автоматически генерировать специальные текстовые файлы, называемые "файлы карты", содержащие 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 раздела как заголовок.

Вы можете генерировать разделы только в секции Невидимые разделы

Это второе ограничение следует из первого. Так как автосгенерированные разделы не могут иметь реальных заголовков, они всегда генерируются в секции Невидимые разделы и определяются как всплывающие разделы в их вкладках Опции раздела (по умолчанию для разделов в этой секции).

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

Если Вы должны использовать функцию, чтобы генерировать разделы в Содержании, Вы должны перетащить их в Содержание мышью после их генерации и редактировать их заголовки вручную.

См. также:

Автогенерация контекстно-зависимых разделов

Инструмент контекста справки

Использование контекстно-зависимой справки