Главная · Все классы · Все функции · Обзоры

Q3ActionGroup Class Reference
[Qt3Support module]

The Q3ActionGroup class groups actions together. Далее...

 #include <Q3ActionGroup>

Данный класс является частью библиотеки поддержки Qt 3. Он предоставлен для поддержки ранее написанного кода. Мы настоятельно не рекомендуем использовать этот класс в новом коде. Для получения дополнительной информации смотрите Портирование на Qt 4.

Унаследован от Q3Action.

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

Свойства

• exclusive : bool
• usesDropDown : bool

• 11 свойств, унаследованных от Q3Action
• 1 свойство, унаследованное от QObject

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

Переопределённые открытые функции

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

Сигналы

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

Защищенные функции

Переопределённые защищённые функции

• 2 защищённые функции, унаследованные от Q3Action
• 7 защищенных функций, унаследованных от QObject

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

• 6 открытых слота, унаследованных от Q3Action
• 1 открытый слот, унаследованный от QObject
• 5 статических открытых членов, унаследованных от QObject

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

The Q3ActionGroup class groups actions together.

В некоторых ситуациях это полезно для группирования действий вместе. For example, if you have a left justify action, a right justify action and a center action, only one of these actions should be active at any one time, and one simple way of achieving this is to group the actions together in an action group.

An action group can also be added to a menu or a toolbar as a single unit, with all the actions within the action group appearing as separate menu options and toolbar buttons.

The actions in an action group emit their activated() (and for toggle actions, toggled()) signals as usual.

The setExclusive() function is used to ensure that only one action is active at any one time: it should be used with actions which have their toggleAction set to true.

Action group actions appear as individual menu options and toolbar buttons. For exclusive action groups use setUsesDropDown() to display the actions in a subwidget of any widget the action group is added to. For example, the actions would appear in a combobox in a toolbar or as a submenu in a menu.

Actions can be added to an action group using add(), but normally they are added by creating the action with the action group as parent. Actions can have separators dividing them using addSeparator(). Action groups are added to widgets with addTo().

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

exclusive : bool

This property holds whether the action group does exclusive toggling.

If exclusive is true only one toggle action in the action group can ever be active at any one time. If the user chooses another toggle action in the group the one they chose becomes active and the one that was active becomes inactive.

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

Смотрите также Q3Action::toggleAction.

usesDropDown : bool

This property holds whether the group's actions are displayed in a subwidget of the widgets the action group is added to.

Exclusive action groups added to a toolbar display their actions in a combobox with the action's Q3Action::text and Q3Action::iconSet properties shown. Non-exclusive groups are represented by a tool button showing their Q3Action::iconSet and text() property.

In a popup menu the member actions are displayed in a submenu.

Changing usesDropDown only affects subsequent calls to addTo().

This property's default is false.

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

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

Q3ActionGroup::Q3ActionGroup ( QObject * parent, const char * name = 0 )

Constructs an action group called name, with parent parent.

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

Q3ActionGroup::Q3ActionGroup ( QObject * parent, const char * name, bool exclusive )

Constructs an action group called name, with parent parent.

If exclusive is true only one toggle action in the group will ever be active.

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

Q3ActionGroup::~Q3ActionGroup ()

Удаляет объект и освобождает выделенные ему ресурсы.

void Q3ActionGroup::activated ( Q3Action * action )   [signal]

This signal is emitted from groups when one of its actions gets activated.

The argument is the action which was activated.

Смотрите также setExclusive(), isOn() и Q3Action::toggled().

void Q3ActionGroup::add ( Q3Action * action )

Adds action action to this group.

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

Смотрите также addTo().

void Q3ActionGroup::addSeparator ()

Adds a separator to the group.

bool Q3ActionGroup::addTo ( QWidget * w )   [virtual]

Reimplemented from Q3Action::addTo().

Adds this action group to the widget w.

If isExclusive() is false or usesDropDown() is false, the actions within the group are added to the widget individually. For example, if the widget is a menu, the actions will appear as individual menu options, and if the widget is a toolbar, the actions will appear as toolbar buttons.

If both isExclusive() and usesDropDown() are true, the actions are presented either in a combobox (if w is a toolbar) or in a submenu (if w is a menu).

All actions should be added to the action group before the action group is added to the widget. If actions are added to the action group after the action group has been added to the widget these later actions will not appear.

See also setExclusive(), setUsesDropDown(), and removeFrom().

void Q3ActionGroup::addedTo ( QWidget * actionWidget, QWidget * container, Q3Action * a )   [virtual protected]

This function is called from the addTo() function when it has created a widget (actionWidget) for the child action a in the container.

void Q3ActionGroup::addedTo ( int index, Q3PopupMenu * menu, Q3Action * a )   [virtual protected]

Это перегруженная функция.

This function is called from the addTo() function when it has created a menu item for the child action at the index position index in the popup menu menu.

void Q3ActionGroup::addedTo ( QWidget * actionWidget, QWidget * container )   [virtual protected]

Reimplemented from Q3Action::addedTo().

Это перегруженная функция.

This function is called from the addTo() function when it has created a widget (actionWidget) in the container.

void Q3ActionGroup::addedTo ( int index, Q3PopupMenu * menu )   [virtual protected]

Reimplemented from Q3Action::addedTo().

Это перегруженная функция.

This function is called from the addTo() function when it has created a menu item at the index position index in the popup menu menu.

void Q3ActionGroup::childEvent ( QChildEvent * e )   [virtual protected]

Переопределено из QObject::childEvent().

void Q3ActionGroup::insert ( Q3Action * action )

Use add(action) instead.

bool Q3ActionGroup::removeFrom ( QWidget * w )   [virtual]

Reimplemented from Q3Action::removeFrom().

void Q3ActionGroup::selected ( Q3Action * action )   [signal]

This signal is emitted from exclusive groups when toggle actions change state.

The argument is the action whose state changed to "on".

Смотрите также setExclusive(), isOn() и Q3Action::toggled().

void Q3ActionGroup::setEnabled ( bool enable )   [virtual]

Reimplemented from Q3Action::setEnabled().

void Q3ActionGroup::setIconSet ( const QIcon & icon )   [virtual]

Reimplemented from Q3Action::setIconSet().

void Q3ActionGroup::setMenuText ( const QString & text )   [virtual]

Reimplemented from Q3Action::setMenuText().

void Q3ActionGroup::setOn ( bool on )   [virtual]

Reimplemented from Q3Action::setOn().

void Q3ActionGroup::setText ( const QString & txt )   [virtual]

Reimplemented from Q3Action::setText().

void Q3ActionGroup::setToggleAction ( bool toggle )   [virtual]

Reimplemented from Q3Action::setToggleAction().

void Q3ActionGroup::setToolTip ( const QString & text )   [virtual]

Reimplemented from Q3Action::setToolTip().

void Q3ActionGroup::setVisible ( bool visible )   [virtual]

Reimplemented from Q3Action::setVisible().

void Q3ActionGroup::setWhatsThis ( const QString & text )   [virtual]

Reimplemented from Q3Action::setWhatsThis().