Класс QActionGroup

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

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

Типы публичного доступа

Свойства

• enabled : bool
• exclusionPolicy : QActionGroup::ExclusionPolicy
• visible : bool

Публичные функции

Свойства публичного доступа

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

QActionGroup — базовый класс для классов, группирующих объекты QAction вместе.

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

См. также QAction.

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

Перечисление QActionGroup::ExclusionPolicy

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

См. также exclusionPolicy.

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

QActionGroup::QActionGroup(QObject *parent)

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

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

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

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

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

Включить или выключить проверку исключения группы

Это вспомогательный метод, который вызывает setExclusionPolicy(ExclusionPolicy::Exclusive) при b истинно, в противном случае setExclusionPolicy(QActionGroup::ExclusionPolicy::None).

См. также isExclusive() и QActionGroup::exclusionPolicy.

[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 если ни одно не отмечено.

bool QActionGroup::isExclusive() const

Возвращает true, если группа является эксклюзивной.

Группа является эксклюзивной, если ExclusionPolicy имеет значение Exclusive или ExclusionOptional.

void QActionGroup::removeAction(QAction *action)

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

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