From d796c9dd933ab96ec83b9a634feedd5d32e1ba3f Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Tue, 8 Nov 2011 12:31:36 -0600 Subject: Test conversion to TQt3 from Qt3 8c6fc1f8e35fd264dd01c582ca5e7549b32ab731 --- doc/html/qactiongroup.html | 219 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 219 insertions(+) create mode 100644 doc/html/qactiongroup.html (limited to 'doc/html/qactiongroup.html') diff --git a/doc/html/qactiongroup.html b/doc/html/qactiongroup.html new file mode 100644 index 000000000..4a4ef8d31 --- /dev/null +++ b/doc/html/qactiongroup.html @@ -0,0 +1,219 @@ + + + + + +TQActionGroup Class + + + + + + + +
+ +Home + | +All Classes + | +Main Classes + | +Annotated + | +Grouped Classes + | +Functions +

TQActionGroup Class Reference

+ +

The TQActionGroup class groups actions together. +More... +

#include <qaction.h> +

Inherits TQAction. +

List of all member functions. +

Public Members

+ +

Signals

+ +

Properties

+ +

Detailed Description

+ + +The TQActionGroup 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. +

Here's an example from examples/textedit: + + +

        TQActionGroup *grp = new TQActionGroup( this );
+        connect( grp, SIGNAL( selected( TQAction* ) ), this, SLOT( textAlign( TQAction* ) ) );
+
+

Here we create a new action group. Since the action group is exclusive +by default, only one of the actions in the group is ever active at any +one time. We then connect the group's selected() signal to our +textAlign() slot. +

        actionAlignLeft = new TQAction( TQPixmap::fromMimeSource( "textleft.xpm" ), tr( "&Left" ), CTRL + Key_L, grp, "textLeft" );
+        actionAlignLeft->setToggleAction( TRUE );
+
+

We create a left align action, add it to the toolbar and the menu +and make it a toggle action. We create center and right align +actions in exactly the same way. +

+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(). +

See also Main Window and Related Classes and Basic Widgets. + +

Member Function Documentation

+

TQActionGroup::TQActionGroup ( TQObject * 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. + +

TQActionGroup::TQActionGroup ( TQObject * 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. + +

TQActionGroup::~TQActionGroup () +

+Destroys the object and frees allocated resources. + +

void TQActionGroup::add ( TQAction * 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(). + +

void TQActionGroup::addSeparator () +

+Adds a separator to the group. + +

bool TQActionGroup::addTo ( TQWidget * 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 exclusive, usesDropDown, and removeFrom(). + +

Example: themes/themes.cpp. +

Reimplemented from TQAction. +

void TQActionGroup::insert ( TQAction * a ) +

+

This function is obsolete. It is provided to keep old source working. We strongly advise against using it in new code. +

Use add() instead, or better still create the action with the action +group as its parent. + +

bool TQActionGroup::isExclusive () const +

Returns TRUE if the action group does exclusive toggling; otherwise returns FALSE. +See the "exclusive" property for details. +

void TQActionGroup::selected ( TQAction * ) [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 exclusive, on, and TQAction::toggled(). + +

Examples: chart/chartform.cpp and textedit/textedit.cpp. +

void TQActionGroup::setExclusive ( bool ) +

Sets whether the action group does exclusive toggling. +See the "exclusive" property for details. +

void TQActionGroup::setUsesDropDown ( bool enable ) +

Sets whether the group's actions are displayed in a subwidget of the widgets the action group is added to to enable. +See the "usesDropDown" property for details. +

bool TQActionGroup::usesDropDown () const +

Returns TRUE if the group's actions are displayed in a subwidget of the widgets the action group is added to; otherwise returns FALSE. +See the "usesDropDown" property for details. +

Property Documentation

+

bool exclusive

+

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

See also TQAction::toggleAction. + +

Set this property's value with setExclusive() and get this property's value with isExclusive(). +

bool usesDropDown

+

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 TQAction::text and TQAction::iconSet properties shown. Non-exclusive groups are +represented by a tool button showing their TQAction::iconSet and +-- depending on TQMainWindow::usesTextLabel() -- text() +property. +

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

Changing usesDropDown only affects subsequent calls to addTo(). +

Note that setting this property for actions in a combobox causes +calls to their TQAction::setVisible(), +TQAction::setEnabled(), and +TQAction::setDisabled() functions to have no effect. +

This property's default is FALSE. +

+

Set this property's value with setUsesDropDown() and get this property's value with usesDropDown(). + +

+This file is part of the TQt toolkit. +Copyright © 1995-2007 +Trolltech. All Rights Reserved.

+ +
Copyright © 2007 +TrolltechTrademarks +
TQt 3.3.8
+
+ -- cgit v1.2.1