Описание класса QActionGroup

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

 #include <QActionGroup>

Унаследован от: QObject.

Свойства

enabled : bool
exclusive : bool
visible : bool

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

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

	QActionGroup ( QObject * parent )
	~QActionGroup ()
QList<QAction *>	actions () const
QAction *	addAction ( QAction * action )
QAction *	addAction ( const QString & text )
QAction *	addAction ( const QIcon & icon, const QString & text )
QAction *	checkedAction () const
bool	isEnabled () const
bool	isExclusive () const
bool	isVisible () const
void	removeAction ( QAction * action )

29 открытых функций, унаследованных от QObject

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

void	setDisabled ( bool b )
void	setEnabled ( bool )
void	setExclusive ( bool )
void	setVisible ( bool )

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

Сигналы

void	hovered ( QAction * action )
void	triggered ( QAction * action )

1 сигнал, унаследованный от QObject

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

7 статических открытых членов, унаследованных от QObject
8 защищенных функций, унаследованных от QObject

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

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

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

Вот пример (из примера "Menus"):

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

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

Параметры выравнивания в QMenu

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

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

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

Смотрите также QAction.

Описание свойств

enabled : bool

Это свойство определяет, является ли группа действий включённой.

Каждое действие в группе действий будет включено или отключено, до тех пор пока оно не будет явно отключено.

Функции доступа:

bool	isEnabled () const
void	setEnabled ( bool )

Смотрите также QAction::setEnabled().

exclusive : bool

Это свойство указывает, делает ли группа действий отметку монопольной.

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

Функции доступа:

bool	isExclusive () const
void	setExclusive ( bool )

Смотрите также QAction::checkable.

visible : bool

Это свойство определяет, является ли группа действий видимой.

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

Функции доступа:

bool	isVisible () const
void	setVisible ( bool )

Смотрите также QAction::setEnabled().

Описание функций-членов

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 )

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

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

QAction * QActionGroup::checkedAction () const

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

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

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

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

void QActionGroup::removeAction ( QAction * action )

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

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

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

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

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

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

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

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

Оглавление

Описание класса QActionGroup

Свойства

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

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

Сигналы

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

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

Описание свойств

enabled : bool

exclusive : bool

visible : bool

Описание функций-членов

QActionGroup::QActionGroup ( QObject * parent )

QActionGroup::~QActionGroup ()

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

QAction * QActionGroup::addAction ( QAction * action )

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

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

QAction * QActionGroup::checkedAction () const

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

void QActionGroup::removeAction ( QAction * action )

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

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

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

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

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