Home | All Classes | Main Classes | Annotated | Grouped Classes | Functions

QButtonGroup Class Reference

The QButtonGroup widget organizes QButton widgets in a group. More...

#include <QButtonGroup>

Inherits QObject.

List of all members.

Writable Properties

Public Functions

Public Slots

Signals

Static Public Members

Protected Functions


Detailed Description

The QButtonGroup widget organizes QButton widgets in a group.

An exclusive button group switches off all checkable (toggle) buttons except the one that was clicked. By default, a button group is exclusive. The buttons in a button group are usually checkable QPushButton's, QCheckBoxes (normally for non-exclusive button groups), or QRadioButtons.

A button is added to the group with addButton(). It can be removed from the group with removeButton(). If the group is exclusive, the currently checked button is available as checkedButton(). If a button is checked the buttonChecked() signal is emitted. The number of buttons in the group is returned by count().

Screenshot in Motif style Screenshot in Windows style

See also QPushButton, QCheckBox, and QRadioButton.


Property Documentation

exclusive : bool

This property holds whether the button group is exclusive.

If this property is true, then the buttons in the group are checked (toggled), and to untoggle a button you must click on another button in the group. The default value is true.

Access functions:


Member Function Documentation

QButtonGroup::QButtonGroup ( QObject * parent = 0 )

Constructs a new, empty button group with the given parent.

See also addButton() and setExclusive().

QButtonGroup::~QButtonGroup ()

Destroys the button group and all its child widgets.

void QButtonGroup::addButton ( QAbstractButton * button )

Adds the given button to the button group.

See also removeButton() and count().

void QButtonGroup::buttonChecked ( QAbstractButton * button )   [signal]

This signal is emitted when the given button is checked.

See also checkedButton().

QAbstractButton * QButtonGroup::checkedButton () const

Returns the button group's checked button, or 0 if no buttons are checked.

See also buttonChecked().

int QButtonGroup::count () const

Returns the number of buttons in the group.

void QButtonGroup::removeButton ( QAbstractButton * button )

Removes the given button from the button group.

See also addButton() and count().


Copyright © 2004 Trolltech. Trademarks
Qt 4.0.0-tp1