Класс 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 имеет значение true, группа действий отключена; в противном случае она включена.

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

Включает или отключает эксклюзивную проверку группы.

Это вспомогательный метод, который вызывает setExclusionPolicy(ExclusionPolicy::Exclusive), когда b имеет значение true, а в противном случае — 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().