На этом шаге мы рассмотрим назначение, конструктор и основные методы этого класса.

    Класс QActionGroup позволяет объединить несколько действий-переключателей в группу. По умолчанию внутри группы может быть установлен только один переключатель - при попытке установить другой переключатель ранее установленный будет автоматически сброшен. Иерархия наследования для этого класса выглядит так:

  QObject - QActionGroup

    Конструктор класса QActionGroup имеет следующий формат:

  <Объект> = QActionGroup(<QObject>)

    В параметре <QObject> указывается ссылка на родительский компонент или значение None. После создания объекта группы он может быть указан в качестве родителя при создании объектов действия - в этом случае действие автоматически добавляется в группу.

    Класс QActionGroup поддерживает следующие основные методы:

• addAction () - добавляет объект действия в группу. Метод возвращает экземпляр класса QAction. Форматы метода:

    addAction(<QAction>) 
    addAction(<Название>) 
    addAction(<QIcon>, <Название>)
  

• removeAction (<QAction>) - удаляет объект действия из группы;

• actions () - возвращает список с экземплярами класса QAction, которые были добавлены в группу, или пустой список;

• checkedAction () - возвращает ссылку (экземпляр класса QAction) на установленный переключатель внутри группы при использовании эксклюзивного режима или значение None;

• setExclusive (<Флаг>) - если в качестве параметра указано значение False, внутри группы может быть установлено произвольное количество действий-переключателей. Значение True возвращает эксклюзивный режим, при котором только одно действие-переключатель может быть установлено. Метод является слотом;

• setDisabled (<Флаг>) - если в качестве параметра указано значение True, все действия в группе станут недоступными. Значение False делает действия вновь доступными. Метод является слотом;

• setEnabled (<Флаг>) - если в качестве параметра указано значение False, все действия в группе станут недоступными. Значение True делает действия вновь доступными. Метод является слотом;

• isEnabled () - возвращает значение True, если действия в группе доступны, и False - в противном случае;

• setVisible (<Флаг>) - если в качестве параметра указано значение False, все действия в группе будут скрыты. Значение True вновь выводит действия на экран. Метод является слотом;

• isVisible () - возвращает значение False, если действия группы скрыты, и True - в противном случае.

    Класс QActionGroup поддерживает сигналы:

• hovered (<QAction>) - генерируется при наведении указателя мыши на объект действия внутри группы. Внутри обработчика через параметр доступна ссылка на этот объект действия;
• triggered (<QAction>) - генерируется при выборе пункта меню, нажатии кнопки на панели инструментов или комбинации клавиш. Внутри обработчика через параметр доступна ссылка на этот объект действия.

    На следующем шаге мы рассмотрим панели инструментов.

Предыдущий шаг Содержание Следующий шаг