Идентификатор помощи
Идентификатор помощи обычно хранится в слоте help-key
экземпляров класса capi::simple-element или в аналогичном слоте
объектов других классов.
Он представляет из собой список или другой Лисп-объект, в котором "зашито" до
трёх идентификаторов
- topic-id
- идентификатор статьи книги помощи,
- context-id
- идентификатор контекстной подсказки,
- tooltip
- строка всплывающей подсказки в двойных кавычках.
Формально, идентификатор помощи имеет один из следующих видов.
- tooltip
- Простейший идентификатор, состоящий только
всплывающей подсказки. Если запрашивается
контекстная помощь, то это строка также может быть показана, в зависимости от
настроек.
(topic-id context-id)
- Отличающиеся идентификаторы статьи и контекстной подсказки.
(topic-id context-id . tooltip)
- Полная спецификация, в которую "зашиты" все три идентификатора.
(id . tooltip),
(id)
- Сокращенная спецификация, когда один и тот же описатель id
идентифицирует и статью, и контекстную подсказку, т.е. задаёт и topic-id,
и context-id.
- id
- Сокращение для
(id),
применяемое для тех объектов, для которых всплывающая подсказка бессмысленна,
например, для подклассов окон capi:interface.
- :parent
- Означает, что идентификатор помощи берётся из непосредственного
родительского расклада, т.е. через
capi:element-parent.