Q3ActionGroup Class Reference

#include <q3action.h>

Inheritance diagram for Q3ActionGroup:

[legend]Collaboration diagram for Q3ActionGroup:

[legend]List of all members.

---

Detailed Description

The Q3ActionGroup class groups actions together.

In some situations it is useful to group 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().

Definition at line 139 of file q3action.h.

Signals
void	selected (Q3Action *)
void	activated (Q3Action *)
Public Member Functions
	Q3ActionGroup (QObject *parent, const char *name=0)
	Q3ActionGroup (QObject *parent, const char *name, bool exclusive)
	~Q3ActionGroup ()
void	setExclusive (bool)
bool	isExclusive () const
void	add (Q3Action *a)
void	addSeparator ()
bool	addTo (QWidget *)
bool	removeFrom (QWidget *)
void	setEnabled (bool)
void	setToggleAction (bool toggle)
void	setOn (bool on)
void	setVisible (bool)
void	setUsesDropDown (bool enable)
bool	usesDropDown () const
void	setIconSet (const QIcon &)
void	setText (const QString &)
void	setMenuText (const QString &)
void	setToolTip (const QString &)
void	setWhatsThis (const QString &)
void	insert (Q3Action *a)
Protected Member Functions
void	childEvent (QChildEvent *)
virtual void	addedTo (QWidget *actionWidget, QWidget *container, Q3Action *a)
virtual void	addedTo (int index, Q3PopupMenu *menu, Q3Action *a)
virtual void	addedTo (QWidget *actionWidget, QWidget *container)
virtual void	addedTo (int index, Q3PopupMenu *menu)
Private Slots
void	childToggled (bool)
void	childActivated ()
void	childDestroyed ()
void	internalComboBoxActivated (int)
void	internalComboBoxHighlighted (int)
void	internalToggle (Q3Action *)
void	objectDestroyed ()
Private Attributes
Q3ActionGroupPrivate *	d

---

Constructor & Destructor Documentation

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

Constructs an action group called name, with parent parent.

The action group is exclusive by default. Call setExclusive(false) to make the action group non-exclusive.

Definition at line 1432 of file q3action.cpp.

References QObject::connect(), d, Q3ActionGroupPrivate::dropdown, Q3ActionGroupPrivate::exclusive, internalToggle(), selected(), Q3ActionGroupPrivate::selected, Q3ActionGroupPrivate::separatorAction, SIGNAL, and SLOT.

    : Q3Action(parent, name)
{
    d = new Q3ActionGroupPrivate;
    d->exclusive = true;
    d->dropdown = false;
    d->selected = 0;
    d->separatorAction = 0;

    connect(this, SIGNAL(selected(Q3Action*)), SLOT(internalToggle(Q3Action*)));
}

Here is the call graph for this function:

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.

See also:

exclusive

Definition at line 1452 of file q3action.cpp.

References QObject::connect(), d, Q3ActionGroupPrivate::dropdown, Q3ActionGroupPrivate::exclusive, internalToggle(), selected(), Q3ActionGroupPrivate::selected, Q3ActionGroupPrivate::separatorAction, SIGNAL, and SLOT.

    : Q3Action(parent, name)
{
    d = new Q3ActionGroupPrivate;
    d->exclusive = exclusive;
    d->dropdown = false;
    d->selected = 0;
    d->separatorAction = 0;

    connect(this, SIGNAL(selected(Q3Action*)), SLOT(internalToggle(Q3Action*)));
}

Here is the call graph for this function:

Q3ActionGroup::~Q3ActionGroup

(

)

Destroys the object and frees allocated resources.

Definition at line 1468 of file q3action.cpp.

References Q3ActionPrivate::Action4Item::action, Q3ActionGroupPrivate::action4items, QList< T >::begin(), Q3ActionGroupPrivate::comboboxes, d, QObject::destroyed(), QList< T >::end(), QList< T >::isEmpty(), Q3ActionGroupPrivate::menubuttons, Q3ActionGroupPrivate::menuitems, objectDestroyed(), Q3ActionGroupPrivate::popupmenus, Q3ActionGroupPrivate::separatorAction, SIGNAL, SLOT, and QList< T >::takeFirst().

{
    QList<Q3ActionGroupPrivate::MenuItem*>::Iterator mit(d->menuitems.begin());
    while (mit != d->menuitems.end()) {
        Q3ActionGroupPrivate::MenuItem *mi = *mit;
        ++mit;
        if (mi->popup)
            mi->popup->disconnect(SIGNAL(destroyed()), this, SLOT(objectDestroyed()));
    }

    QList<QComboBox*>::Iterator cbit(d->comboboxes.begin());
    while (cbit != d->comboboxes.end()) {
        QComboBox *cb = *cbit;
        ++cbit;
        cb->disconnect(SIGNAL(destroyed()), this, SLOT(objectDestroyed()));
    }
    QList<QToolButton*>::Iterator mbit(d->menubuttons.begin());
    while (mbit != d->menubuttons.end()) {
        QToolButton *mb = *mbit;
        ++mbit;
        mb->disconnect(SIGNAL(destroyed()), this, SLOT(objectDestroyed()));
    }
    QList<Q3PopupMenu*>::Iterator pmit(d->popupmenus.begin());
    while (pmit != d->popupmenus.end()) {
        Q3PopupMenu *pm = *pmit;
        ++pmit;
        pm->disconnect(SIGNAL(destroyed()), this, SLOT(objectDestroyed()));
    }

    QList<Q3ActionGroupPrivate::Action4Item*>::Iterator itmi4(d->action4items.begin());
    Q3ActionGroupPrivate::Action4Item* mi4;
    while (itmi4 != d->action4items.end()) {
        mi4 = *itmi4;
        ++itmi4;
        mi4->widget->removeAction(mi4->action);
    }
    delete Q3ActionPrivate::Action4Item::action;
    Q3ActionPrivate::Action4Item::action = 0;

    delete d->separatorAction;
    while (!d->menubuttons.isEmpty())
        delete d->menubuttons.takeFirst();
    while (!d->comboboxes.isEmpty())
        delete d->comboboxes.takeFirst();
    while (!d->menuitems.isEmpty())
        delete d->menuitems.takeFirst();
    while (!d->popupmenus.isEmpty())
        delete d->popupmenus.takeFirst();
    delete d;
}

Here is the call graph for this function:

---

Member Function Documentation

void Q3ActionGroup::setExclusive

(

bool

)

Definition at line 1530 of file q3action.cpp.

References d, and Q3ActionGroupPrivate::exclusive.

{
    d->exclusive = enable;
}

bool Q3ActionGroup::isExclusive

(

)

const

Definition at line 1535 of file q3action.cpp.

References d, and Q3ActionGroupPrivate::exclusive.

Referenced by childToggled().

{
    return d->exclusive;
}

void Q3ActionGroup::add

(

Q3Action *

action

)

Adds action action to this group.

Normally an action is added to a group by creating it with the group as parent, so this function is not usually used.

See also:

addTo()

Definition at line 1576 of file q3action.cpp.

References Q3ActionGroupPrivate::action4items, Q3ActionGroupPrivate::actions, Q3Action::activated(), QList< T >::append(), QList< T >::begin(), childActivated(), childDestroyed(), childToggled(), Q3ActionGroupPrivate::comboboxes, QObject::connect(), QList< T >::contains(), d, QObject::destroyed(), QList< T >::end(), Q3Action::isEnabled(), Q3Action::isVisible(), Q3ActionGroupPrivate::menubuttons, Q3ActionGroupPrivate::menuitems, SIGNAL, SLOT, Q3Action::toggled(), Q3Action::toolTip(), and Q3Action::whatsThis().

{
    if (d->actions.contains(action))
        return;

    d->actions.append(action);

    if (action->whatsThis().isNull())
        action->setWhatsThis(whatsThis());
    if (action->toolTip().isNull())
        action->setToolTip(toolTip());
    if (!action->d->forceDisabled)
  action->d->enabled = isEnabled();
    if (!action->d->forceInvisible)
  action->d->visible = isVisible();

    connect(action, SIGNAL(destroyed()), this, SLOT(childDestroyed()));
    connect(action, SIGNAL(activated()), this, SIGNAL(activated()));
    connect(action, SIGNAL(toggled(bool)), this, SLOT(childToggled(bool)));
    connect(action, SIGNAL(activated()), this, SLOT(childActivated()));

    for (QList<QComboBox*>::Iterator cb(d->comboboxes.begin()); cb != d->comboboxes.end(); ++cb)
        action->addTo(*cb);
    for (QList<QToolButton*>::Iterator mb(d->menubuttons.begin()); mb != d->menubuttons.end(); ++mb) {
        QMenu* menu = (*mb)->popup();
        if (!menu)
            continue;
        action->addTo(menu);
    }
    for (QList<Q3ActionGroupPrivate::Action4Item*>::Iterator ac(d->action4items.begin());
         ac != d->action4items.end(); ++ac)
        action->addTo((*ac)->action->menu());
    for (QList<Q3ActionGroupPrivate::MenuItem*>::Iterator mi(d->menuitems.begin());
         mi != d->menuitems.end(); ++mi) {
        Q3PopupMenu* popup = (*mi)->popup;
        if (!popup)
            continue;
        action->addTo(popup);
    }
}

Here is the call graph for this function:

void Q3ActionGroup::addSeparator

(

)

Adds a separator to the group.

Definition at line 1620 of file q3action.cpp.

References Q3ActionGroupPrivate::actions, QList< T >::append(), d, Q3Action::Q3Action(), and Q3ActionGroupPrivate::separatorAction.

{
    if (!d->separatorAction)
        d->separatorAction = new Q3Action(0, "qt_separator_action");
    d->actions.append(d->separatorAction);
}

Here is the call graph for this function:

bool Q3ActionGroup::addTo

(

QWidget *

w

)

[virtual]

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() removeFrom()

Reimplemented from Q3Action.

Definition at line 1647 of file q3action.cpp.

References Q3ActionGroupPrivate::Action4Item::action, Q3ActionGroupPrivate::action4items, Q3ActionGroupPrivate::actions, Q3Action::activated(), QWidget::addAction(), addedTo(), QList< T >::append(), QList< T >::begin(), Q3ActionGroupPrivate::comboboxes, QObject::connect(), d, QObject::destroyed(), Q3ActionGroupPrivate::dropdown, QList< T >::end(), Q3ActionGroupPrivate::exclusive, Q3Action::iconSet(), id, internalComboBoxActivated(), internalComboBoxHighlighted(), isEmpty(), isNull(), QIcon::isNull(), QAction::menu(), QMenu::menuAction(), QToolButton::MenuButtonPopup, Q3ActionGroupPrivate::menubuttons, Q3ActionGroupPrivate::menuitems, Q3Action::menuText(), objectDestroyed(), Q3ActionGroupPrivate::popupmenus, QAction::setIcon(), QAction::setText(), SIGNAL, size, QString::size(), SLOT, Q3Action::text(), Q3Action::toggled(), Q3Action::toolButtonToggled(), Q3Action::toolTip(), Q3ActionGroupPrivate::update(), w, Q3Action::whatsThis(), and Q3ActionGroupPrivate::Action4Item::widget.

{
#ifndef QT_NO_TOOLBAR
    if (qobject_cast<Q3ToolBar*>(w)) {
        if (d->dropdown) {
            if (!d->exclusive) {
                QList<Q3Action*>::Iterator it(d->actions.begin());
                if (!(*it))
                    return true;

                Q3Action *defAction = *it;

                QToolButton* btn = new QToolButton((Q3ToolBar*) w, "qt_actiongroup_btn");
                addedTo(btn, w);
                connect(btn, SIGNAL(destroyed()), SLOT(objectDestroyed()));
                d->menubuttons.append(btn);

                if (!iconSet().isNull())
                    btn->setIconSet(iconSet());
                else if (!defAction->iconSet().isNull())
                    btn->setIconSet(defAction->iconSet());
                if (text().size())
                    btn->setTextLabel(text());
                else if (defAction->text().size())
                    btn->setTextLabel(defAction->text());
#ifndef QT_NO_TOOLTIP
                if (toolTip().size())
                    QToolTip::add(btn, toolTip());
                else if (defAction->toolTip().size())
                    QToolTip::add(btn, defAction->toolTip());
#endif
#ifndef QT_NO_WHATSTHIS
                if (whatsThis().size())
                    QWhatsThis::add(btn, whatsThis());
                else if (defAction->whatsThis().size())
                    QWhatsThis::add(btn, defAction->whatsThis());
#endif

                connect(btn, SIGNAL(clicked()), defAction, SIGNAL(activated()));
                connect(btn, SIGNAL(toggled(bool)), defAction, SLOT(toolButtonToggled(bool)));
                connect(btn, SIGNAL(destroyed()), defAction, SLOT(objectDestroyed()));

                Q3PopupMenu *menu = new Q3PopupMenu(btn, "qt_actiongroup_menu");
                btn->setPopupDelay(0);
                btn->setPopup(menu);
                btn->setPopupMode(QToolButton::MenuButtonPopup);

                while (it != d->actions.end()) {
                    (*it)->addTo(menu);
                    ++it;
                }
                d->update(this);
                return true;
            } else {
                QComboBox *box = new QComboBox(false, w, "qt_actiongroup_combo");
                addedTo(box, w);
                connect(box, SIGNAL(destroyed()), SLOT(objectDestroyed()));
                d->comboboxes.append(box);
#ifndef QT_NO_TOOLTIP
                if (toolTip().size())
                    QToolTip::add(box, toolTip());
#endif
#ifndef QT_NO_WHATSTHIS
                if (whatsThis().size())
                    QWhatsThis::add(box, whatsThis());
#endif
                int onIndex = 0;
                bool foundOn = false;
                for (QList<Q3Action*>::Iterator it(d->actions.begin()); it != d->actions.end(); ++it) {
                    Q3Action *action = *it;
                    if (!foundOn)
                        foundOn = action->isOn();
                    if (action->objectName() != QLatin1String("qt_separator_action") && !foundOn)
                        onIndex++;
                    action->addTo(box);
                }
                if (foundOn)
                    box->setCurrentItem(onIndex);
                connect(box, SIGNAL(activated(int)), this, SLOT(internalComboBoxActivated(int)));
                connect(box, SIGNAL(highlighted(int)), this, SLOT(internalComboBoxHighlighted(int)));
                d->update(this);
                return true;
            }
        }
    } else
#endif
    if (::qobject_cast<Q3PopupMenu*>(w)) {
        Q3PopupMenu *popup;
        if (d->dropdown) {
            Q3PopupMenu *menu = (Q3PopupMenu*)w;
            popup = new Q3PopupMenu(w, "qt_actiongroup_menu");
            d->popupmenus.append(popup);
            connect(popup, SIGNAL(destroyed()), SLOT(objectDestroyed()));

            int id;
            if (!iconSet().isNull()) {
                if (menuText().isEmpty())
                    id = menu->insertItem(iconSet(), text(), popup);
                else
                    id = menu->insertItem(iconSet(), menuText(), popup);
            } else {
                if (menuText().isEmpty())
                    id = menu->insertItem(text(), popup);
                else
                    id = menu->insertItem(menuText(), popup);
            }

            addedTo(menu->indexOf(id), menu);

            Q3ActionGroupPrivate::MenuItem *item = new Q3ActionGroupPrivate::MenuItem;
            item->id = id;
            item->popup = popup;
            d->menuitems.append(item);
        } else {
            popup = (Q3PopupMenu*)w;
        }
        for (QList<Q3Action*>::Iterator it(d->actions.begin()); it != d->actions.end(); ++it) {
            // #### do an addedTo(index, popup, action), need to find out index
            (*it)->addTo(popup);
        }
        return true;
    }
    if (::qobject_cast<QMenu*>(w)) {
        QMenu *menu = (QMenu*)w;
        if (d->dropdown) {
            Q3ActionGroupPrivate::Action4Item *ai = new Q3ActionGroupPrivate::Action4Item;
            if(!ai->action)  { //static
                ai->action = menu->menuAction();
                if (!iconSet().isNull())
                    ai->action->setIcon(iconSet());
                if (menuText().isEmpty())
                    ai->action->setText(text());
                else
                    ai->action->setText(menuText());
            }
            addedTo(w, w);
            ai->widget = w;
            ai->widget->addAction(Q3ActionGroupPrivate::Action4Item::action);
            d->action4items.append(ai);
            menu = ai->action->menu();
        }
        for (QList<Q3Action*>::Iterator it(d->actions.begin()); it != d->actions.end(); ++it)
            (*it)->addTo(menu);
        return true;
    }
    for (QList<Q3Action*>::Iterator it(d->actions.begin()); it != d->actions.end(); ++it) {
        // #### do an addedTo(index, popup, action), need to find out index
        (*it)->addTo(w);
    }
    return true;
}

Here is the call graph for this function:

bool Q3ActionGroup::removeFrom

(

QWidget *

w

)

[virtual]

Reimplemented from Q3Action.

Definition at line 1801 of file q3action.cpp.

References Q3ActionGroupPrivate::action4items, Q3ActionGroupPrivate::actions, QList< T >::begin(), Q3ActionGroupPrivate::comboboxes, d, Q3ActionGroupPrivate::dropdown, QList< T >::end(), Q3ActionGroupPrivate::menubuttons, Q3ActionGroupPrivate::menuitems, and w.

Referenced by Q3ActionPrivate::~Q3ActionPrivate().

{
    for (QList<Q3Action*>::Iterator it(d->actions.begin()); it != d->actions.end(); ++it)
        (*it)->removeFrom(w);

#ifndef QT_NO_TOOLBAR
    if (::qobject_cast<Q3ToolBar*>(w)) {
        QList<QComboBox*>::Iterator cb(d->comboboxes.begin());
        while (cb != d->comboboxes.end()) {
            QComboBox *box = *cb;
            ++cb;
            if (box->parentWidget() == w)
                delete box;
        }
        QList<QToolButton*>::Iterator mb(d->menubuttons.begin());
        while (mb != d->menubuttons.end()) {
            QToolButton *btn = *mb;
            ++mb;
            if (btn->parentWidget() == w)
                delete btn;
        }
    } else
#endif
    if (::qobject_cast<Q3PopupMenu*>(w)) {
        QList<Q3ActionGroupPrivate::MenuItem*>::Iterator pu(d->menuitems.begin());
        while (pu != d->menuitems.end()) {
            Q3ActionGroupPrivate::MenuItem *mi = *pu;
            ++pu;
            if (d->dropdown && mi->popup)
                ((Q3PopupMenu*)w)->removeItem(mi->id);
            delete mi->popup;
        }
    }
    if (::qobject_cast<QMenu*>(w)) {
        QList<Q3ActionGroupPrivate::Action4Item*>::Iterator it(d->action4items.begin());
        Q3ActionGroupPrivate::Action4Item *a4i;
        while (it != d->action4items.end()) {
            a4i = *it;
            ++it;
            if (a4i->widget == w) {
                a4i->widget->removeAction(a4i->action);
                d->action4items.removeAll(a4i);
                delete a4i;
            }
        }
    }
    return true;
}

Here is the call graph for this function:

void Q3ActionGroup::setEnabled

(

bool

enable

)

[virtual]

Reimplemented from Q3Action.

Definition at line 1899 of file q3action.cpp.

References d, Q3Action::isEnabled(), Q3Action::setEnabled(), and Q3ActionGroupPrivate::update().

{
    if (enable == isEnabled())
        return;
    Q3Action::setEnabled(enable);
    d->update(this);
}

Here is the call graph for this function:

void Q3ActionGroup::setToggleAction

(

bool

toggle

)

[virtual]

Reimplemented from Q3Action.

Definition at line 1909 of file q3action.cpp.

References Q3ActionGroupPrivate::actions, QList< T >::begin(), d, QList< T >::end(), Q3Action::setToggleAction(), and Q3ActionGroupPrivate::update().

{
    for (QList<Q3Action*>::Iterator it(d->actions.begin()); it != d->actions.end(); ++it)
        (*it)->setToggleAction(toggle);
    Q3Action::setToggleAction(true);
    d->update(this);
}

Here is the call graph for this function:

void Q3ActionGroup::setOn

(

bool

on

)

[virtual]

Reimplemented from Q3Action.

Definition at line 1919 of file q3action.cpp.

References Q3ActionGroupPrivate::actions, QList< T >::begin(), d, QList< T >::end(), Q3Action::setOn(), and Q3ActionGroupPrivate::update().

{
    for (QList<Q3Action*>::Iterator it(d->actions.begin()); it != d->actions.end(); ++it) {
        Q3Action *act = *it;
        if (act->isToggleAction())
            act->setOn(on);
    }
    Q3Action::setOn(on);
    d->update(this);
}

Here is the call graph for this function:

void Q3ActionGroup::setVisible

(

bool

visible

)

[virtual]

Reimplemented from Q3Action.

Definition at line 1932 of file q3action.cpp.

References d, Q3Action::setVisible(), and Q3ActionGroupPrivate::update().

{
    Q3Action::setVisible(visible);
    d->update(this);
}

Here is the call graph for this function:

void Q3ActionGroup::setUsesDropDown

(

bool

enable

)

Definition at line 1558 of file q3action.cpp.

References d, and Q3ActionGroupPrivate::dropdown.

{
    d->dropdown = enable;
}

bool Q3ActionGroup::usesDropDown

(

)

const

Definition at line 1563 of file q3action.cpp.

References d, and Q3ActionGroupPrivate::dropdown.

{
    return d->dropdown;
}

void Q3ActionGroup::setIconSet

(

const QIcon &

icon

)

[virtual]

Reimplemented from Q3Action.

Definition at line 1940 of file q3action.cpp.

References d, Q3Action::setIconSet(), and Q3ActionGroupPrivate::update().

{
    Q3Action::setIconSet(icon);
    d->update(this);
}

Here is the call graph for this function:

void Q3ActionGroup::setText

(

const QString &

txt

)

[virtual]

Reimplemented from Q3Action.

Definition at line 1948 of file q3action.cpp.

References d, Q3Action::setText(), Q3Action::text(), and Q3ActionGroupPrivate::update().

{
    if (txt == text())
        return;

    Q3Action::setText(txt);
    d->update(this);
}

Here is the call graph for this function:

void Q3ActionGroup::setMenuText

(

const QString &

text

)

[virtual]

Reimplemented from Q3Action.

Definition at line 1959 of file q3action.cpp.

References d, Q3Action::menuText(), Q3Action::setMenuText(), Q3Action::text(), and Q3ActionGroupPrivate::update().

{
    if (text == menuText())
        return;

    Q3Action::setMenuText(text);
    d->update(this);
}

Here is the call graph for this function:

void Q3ActionGroup::setToolTip

(

const QString &

text

)

[virtual]

Reimplemented from Q3Action.

Definition at line 1970 of file q3action.cpp.

References Q3ActionGroupPrivate::actions, QList< T >::begin(), d, QList< T >::end(), Q3Action::setToolTip(), Q3Action::text(), Q3Action::toolTip(), and Q3ActionGroupPrivate::update().

{
    if (text == toolTip())
        return;
    for (QList<Q3Action*>::Iterator it(d->actions.begin()); it != d->actions.end(); ++it) {
        if ((*it)->toolTip().isNull())
            (*it)->setToolTip(text);
    }
    Q3Action::setToolTip(text);
    d->update(this);
}

Here is the call graph for this function:

void Q3ActionGroup::setWhatsThis

(

const QString &

text

)

[virtual]

Reimplemented from Q3Action.

Definition at line 1984 of file q3action.cpp.

References Q3ActionGroupPrivate::actions, QList< T >::begin(), d, QList< T >::end(), Q3Action::setWhatsThis(), Q3Action::text(), Q3ActionGroupPrivate::update(), and Q3Action::whatsThis().

{
    if (text == whatsThis())
        return;
    for (QList<Q3Action*>::Iterator it(d->actions.begin()); it != d->actions.end(); ++it) {
        if ((*it)->whatsThis().isNull())
            (*it)->setWhatsThis(text);
    }
    Q3Action::setWhatsThis(text);
    d->update(this);
}

Here is the call graph for this function:

void Q3ActionGroup::childEvent

(

QChildEvent *

e

)

[protected, virtual]

Reimplemented from QObject.

Definition at line 1998 of file q3action.cpp.

References Q3ActionGroupPrivate::Action4Item::action, QList< T >::begin(), QChildEvent::child(), Q3ActionGroupPrivate::comboboxes, d, QList< T >::end(), i, Q3ActionGroupPrivate::menubuttons, Q3ActionGroupPrivate::menuitems, QChildEvent::removed(), Q3Action::removeFrom(), and Q3Action::text().

{
    if (!e->removed())
        return;

    Q3Action *action = qobject_cast<Q3Action*>(e->child());
    if (!action)
        return;

    for (QList<QComboBox*>::Iterator cb(d->comboboxes.begin());
         cb != d->comboboxes.end(); ++cb) {
        for (int i = 0; i < (*cb)->count(); i++) {
            if ((*cb)->text(i) == action->text()) {
                (*cb)->removeItem(i);
                break;
            }
        }
    }
    for (QList<QToolButton*>::Iterator mb(d->menubuttons.begin());
         mb != d->menubuttons.end(); ++mb) {
        QMenu* popup = (*mb)->popup();
        if (!popup)
            continue;
        action->removeFrom(popup);
    }
    for (QList<Q3ActionGroupPrivate::MenuItem*>::Iterator mi(d->menuitems.begin());
         mi != d->menuitems.end(); ++mi) {
        Q3PopupMenu* popup = (*mi)->popup;
        if (!popup)
            continue;
        action->removeFrom(popup);
    }
    if(QAction *act = Q3ActionGroupPrivate::Action4Item::action)
        action->removeFrom(act->menu());
}

Here is the call graph for this function:

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

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

Definition at line 2156 of file q3action.cpp.

References a.

Referenced by addTo().

{
    Q_UNUSED(actionWidget);
    Q_UNUSED(container);
    Q_UNUSED(a);
}

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

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. 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.

Definition at line 2171 of file q3action.cpp.

References a.

{
    Q_UNUSED(index);
    Q_UNUSED(menu);
    Q_UNUSED(a);
}

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

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function is called from the addTo() function when it has created a widget (actionWidget) in the container.

Reimplemented from Q3Action.

Definition at line 2186 of file q3action.cpp.

{
    Q_UNUSED(actionWidget);
    Q_UNUSED(container);
}

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

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. 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.

Reimplemented from Q3Action.

Definition at line 2201 of file q3action.cpp.

{
    Q_UNUSED(index);
    Q_UNUSED(menu);
}

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".

See also:

setExclusive(), isOn() Q3Action::toggled()

Referenced by childToggled(), internalComboBoxActivated(), and 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.

See also:

setExclusive(), isOn() Q3Action::toggled()

void Q3ActionGroup::childToggled

(

bool

)

[private, slot]

Definition at line 1852 of file q3action.cpp.

References Q3ActionGroupPrivate::actions, QList< T >::begin(), d, emit, QList< T >::end(), isExclusive(), s, selected(), Q3ActionGroupPrivate::selected, and QObject::sender().

Referenced by add().

{
    if (!isExclusive())
        return;
    Q3Action* s = qobject_cast<Q3Action*>(sender());
    if (!s)
        return;
    if (b) {
        if (s != d->selected) {
            d->selected = s;
            for (QList<Q3Action*>::Iterator it(d->actions.begin()); it != d->actions.end(); ++it) {
                if ((*it)->isToggleAction() && (*it) != s)
                    (*it)->setOn(false);
            }
            emit selected(s);
        }
    } else {
        if (s == d->selected) {
            // at least one has to be selected
            s->setOn(true);
        }
    }
}

void Q3ActionGroup::childActivated

(

)

[private, slot]

Definition at line 1878 of file q3action.cpp.

References Q3Action::activated(), emit, s, and QObject::sender().

Referenced by add().

{
    Q3Action* s = qobject_cast<Q3Action*>(sender());
    if (s) {
        emit activated(s);
        emit Q3Action::activated();
    }
}

void Q3ActionGroup::childDestroyed

(

)

[private, slot]

Definition at line 1890 of file q3action.cpp.

References Q3ActionGroupPrivate::actions, d, QList< T >::removeAll(), Q3ActionGroupPrivate::selected, and QObject::sender().

Referenced by add().

{
    d->actions.removeAll((Q3Action *)sender());
    if (d->selected == sender())
        d->selected = 0;
}

void Q3ActionGroup::internalComboBoxActivated

(

int

)

[private, slot]

Definition at line 2059 of file q3action.cpp.

References a, Q3ActionGroupPrivate::actions, Q3Action::activated(), QList< T >::at(), QList< T >::begin(), QList< T >::count(), d, emit, QList< T >::end(), i, int, selected(), and Q3ActionGroupPrivate::selected.

Referenced by addTo().

{
    if (index == -1)
        return;

    Q3Action *a = 0;
    for (int i = 0; i <= index && i < (int)d->actions.count(); ++i) {
        a = d->actions.at(i);
        if (a && a->objectName() == QLatin1String("qt_separator_action"))
            index++;
    }
    a = d->actions.at(index);
    if (a) {
        if (a != d->selected) {
            d->selected = a;
            for (QList<Q3Action*>::Iterator it(d->actions.begin()); it != d->actions.end(); ++it) {
                if ((*it)->isToggleAction() && (*it) != a)
                    (*it)->setOn(false);
            }
            if (a->isToggleAction())
                a->setOn(true);

            emit activated(a);
            emit Q3Action::activated();
            emit a->activated();
            if (a->isToggleAction())
                emit selected(d->selected);
        } else if (!a->isToggleAction()) {
            emit activated(a);
            emit Q3Action::activated();
            emit a->activated();
        }
        a->clearStatusText();
    }
}

void Q3ActionGroup::internalComboBoxHighlighted

(

int

)

[private, slot]

Definition at line 2097 of file q3action.cpp.

References a, Q3ActionGroupPrivate::actions, QList< T >::at(), Q3Action::clearStatusText(), QList< T >::count(), d, i, and int.

Referenced by addTo().

{
    Q3Action *a = 0;
    for (int i = 0; i <= index && i < (int)d->actions.count(); ++i) {
        a = d->actions.at(i);
        if (a && a->objectName() == QLatin1String("qt_separator_action"))
            index++;
    }
    a = d->actions.at(index);
    if (a)
        a->showStatusText(a->statusTip());
    else
        clearStatusText();
}

void Q3ActionGroup::internalToggle

(

Q3Action *

)

[private, slot]

Definition at line 2114 of file q3action.cpp.

References a, Q3ActionGroupPrivate::actions, QList< T >::at(), QList< T >::begin(), Q3ActionGroupPrivate::comboboxes, d, QList< T >::end(), i, index, and QList< T >::indexOf().

Referenced by Q3ActionGroup().

{
    int index = d->actions.indexOf(a);
    if (index == -1)
        return;

    int lastItem = index;
    for (int i=0; i<lastItem; ++i) {
        Q3Action *action = d->actions.at(i);
        if (action->objectName() == QLatin1String("qt_separator_action"))
            --index;
    }

    for (QList<QComboBox*>::Iterator it(d->comboboxes.begin());
         it != d->comboboxes.end(); ++it)
            (*it)->setCurrentItem(index);
}

void Q3ActionGroup::objectDestroyed

(

)

[private, slot]

Reimplemented from Q3Action.

Definition at line 2134 of file q3action.cpp.

References Q3ActionGroupPrivate::comboboxes, d, Q3ActionGroupPrivate::menubuttons, Q3ActionGroupPrivate::menuitems, Q3ActionGroupPrivate::popupmenus, QList< T >::removeAll(), and QObject::sender().

Referenced by addTo(), and ~Q3ActionGroup().

{
    const QObject* obj = sender();
    d->menubuttons.removeAll((QToolButton *)obj);
    for (QList<Q3ActionGroupPrivate::MenuItem *>::Iterator mi(d->menuitems.begin());
         mi != d->menuitems.end(); ++mi) {
        if ((*mi)->popup == obj) {
            d->menuitems.removeAll(*mi);
            delete *mi;
            break;
        }
    }
    d->popupmenus.removeAll((Q3PopupMenu*)obj);
    d->comboboxes.removeAll((QComboBox*)obj);
}

void Q3ActionGroup::insert

(

Q3Action *

action

)

[inline]

Use add(action) instead.

Definition at line 193 of file q3action.h.

References a.

{ add(a); }

---

Member Data Documentation

Q3ActionGroupPrivate* Q3ActionGroup::d [private]

Reimplemented from Q3Action.

Definition at line 190 of file q3action.h.

Referenced by add(), addSeparator(), addTo(), childDestroyed(), childEvent(), childToggled(), internalComboBoxActivated(), internalComboBoxHighlighted(), internalToggle(), isExclusive(), objectDestroyed(), Q3ActionGroup(), removeFrom(), setEnabled(), setExclusive(), setIconSet(), setMenuText(), setOn(), setText(), setToggleAction(), setToolTip(), setUsesDropDown(), setVisible(), setWhatsThis(), usesDropDown(), and ~Q3ActionGroup().

---

The documentation for this class was generated from the following files:

• src/qt3support/widgets/q3action.h
• src/qt3support/widgets/q3action.cpp

---