Группирование элементов

Команды группирования связывают классы с определенными группами и модулями. Группы используются при генерации списков связанных классов в документации, а модули являются элементами структуры Qt.

Команды

\ingroup

Команда \ingroup указывает, что данный обзор или документированный класс относится к определенной группе связанной документации.

Класс или обзор может принадлежать к нескольким группам.

Аргументом команды \ingroup является имя группы, но обратите внимание, что команда рассматривает остальную часть строки как часть своего аргумента. Убедитесь, что имя группы следует за символом перевода строки.

/ *!
    \class QDir
    \brief The QDir class provides access to directory
           structures and their contents.

    \ingroup io
    ...
* /

Это включит класс QDir в io группу, что означает, например, что QDir будет отображаться в списке, созданном при вызове команды \group с аргументом io.

Для отображения обзоров, связанных с определенной группой, необходимо явно сгенерировать список с помощью команды \generatelist с аргументом related.

См. также \group.

\inmodule

Команда \inmodule связывает класс с модулем, указанным в аргументе команды.

Для основных классов Qt модуль класса определяется его расположением, а именно его директорией. Однако для расширений, таких как ActiveQt и Qt Designer, класс должен быть явно связан с модулем.

Аргументом команды является имя модуля, но обратите внимание, что команда рассматривает остальную часть строки как часть своего аргумента. Убедитесь, что имя модуля следует за символом перевода строки.

/*!
    \class QDesignerTaskMenuExtension
    \inmodule QtDesigner
* /

Это гарантирует, что класс QDesignerTaskMenuExtension включён в модуль Qt Designer, что означает, например, что класс будет отображаться в списке, созданном с помощью команды \generatelist с аргументом {classesbymodule QtDesigner}.

См. также \module и \generatelist.