Идентификатор помощи
Идентификатор помощи обычно хранится в слоте 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
.