Класс QActionGroup

Класс QActionGroup группирует действия вместе. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• enabled : bool
• exclusive : bool
• visible : bool

• 1 свойство унаследовано от QObject

Открытые функции

• 31 открытая функция унаследована от QObject

Открытые слоты

• 1 открытый слот унаследован от QObject

Сигналы

• 2 сигнала унаследованы от QObject

Дополнительные унаследованные члены

• 11 статических открытых членов унаследованы от QObject
• 9 защищённых функций унаследованы от QObject

Подробное описание

Класс QActionGroup группирует действия вместе.

В некоторых ситуациях бывает полезно группировать объекты QAction. Например, если у вас есть действие Выравнивание по левому краю, действие Выравнивание по правому краю, действие Выравнивание по обоим краям и действие Выравнивание по центру, только одно из этих действий должно быть активным в любое время. Один из простых способов достижения этого — группировать действия в группе действий.

Вот пример (из примера Меню):

    alignmentGroup = new QActionGroup(this);
    alignmentGroup->addAction(leftAlignAct);
    alignmentGroup->addAction(rightAlignAct);
    alignmentGroup->addAction(justifyAct);
    alignmentGroup->addAction(centerAct);
    leftAlignAct->setChecked(true);

Здесь мы создаём новую группу действий. Поскольку группа действий по умолчанию является исключительной, только одно из действий в группе может быть выбрано в любой момент времени.

Группа QActionGroup излучает сигнал triggered() при выборе одного из её действий. Каждое действие в группе действий излучает свой сигнал triggered() как обычно.

Как упоминалось выше, группа действий по умолчанию является исключительной; она гарантирует, что только одно действие с возможностью выбора может быть активным в любой момент времени. Если вы хотите сгруппировать действия с возможностью выбора без их исключительности, вы можете отключить исключительность, вызвав setExclusive(false).

Действия могут быть добавлены в группу действий с помощью addAction(), но обычно удобнее указать группу при создании действий; это гарантирует, что действия будут автоматически созданы с родительским элементом. Действия могут быть визуально разделены друг от друга путём добавления действия-разделителя в группу; создайте действие и используйте функцию QAction's setSeparator() для того, чтобы считать его разделителем. Группы действий добавляются в виджеты с помощью функции QWidget::addActions().

См. также QAction.

Документация по членам-функциям

QActionGroup::QActionGroup(QObject *parent)

Создаёт группу действий для объекта parent.

По умолчанию группа действий является исключительной. Вызовите setExclusive(false), чтобы сделать группу действий неисключительной.

QActionGroup::~QActionGroup()

Удаляет группу действий.

QList<QAction *> QActionGroup::actions() const

Возвращает список действий этой группы. Он может быть пустым.

QAction *QActionGroup::addAction(QAction *action)

Добавляет действие action в эту группу и возвращает его.

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

См. также QAction::setActionGroup().

QAction *QActionGroup::addAction(const QString &text)

Создаёт и возвращает действие с текстом text. Созданное действие является потомком этой группы действий.

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

См. также QAction::setActionGroup().

QAction *QActionGroup::addAction(const QIcon &icon, const QString &text)

Создаёт и возвращает действие с текстом и иконкой. Созданное действие является дочерним для этой группы действий.

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

См. также QAction::setActionGroup().

QAction *QActionGroup::checkedAction() const

Возвращает текущее выбранное действие в группе или 0, если ни одно не выбрано.

[signal] void QActionGroup::hovered(QAction *action)

Этот сигнал испускается, когда заданное действие в группе действий выделяется пользователем; например, когда пользователь останавливает курсор над пунктом меню, кнопкой инструментальной панели или нажимает сочетание клавиш для запуска действия.

См. также QAction::activate().

void QActionGroup::removeAction(QAction *action)

Удаляет действие из этой группы. В результате действие не будет иметь родителя.

См. также QAction::setActionGroup().

[slot] void QActionGroup::setDisabled(bool b)

Это вспомогательная функция для свойства enabled, полезная для соединений сигналов—слотов. Если b равно true, группа действий отключена; в противном случае она включена.

[signal] void QActionGroup::triggered(QAction *action)

Этот сигнал испускается, когда заданное действие в группе действий активируется пользователем; например, когда пользователь нажимает на пункт меню, кнопку инструментальной панели или сочетание клавиш для запуска действия.

Подключитесь к этому сигналу для командных действий.

См. также QAction::activate().