Класс QActionGroup

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

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

Свойства

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

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

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

Сигналы

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

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

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

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

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

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

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

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

См. также QAction.

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

QActionGroup::QActionGroup(QObject *parent)

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

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

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

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

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

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

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

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

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

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

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

[virtual] 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)

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

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

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

QAction *QActionGroup::checkedAction() const

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

void QActionGroup::removeAction(QAction *action)

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

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