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

QButtonGroup Class Reference

The QButtonGroup class provides a container to organize groups of button widgets. More...

#include <QButtonGroup>

Inherits QObject.

Writable Properties

Public Functions

Public Slots

Signals

Static Public Members

Protected Functions


Detailed Description

The QButtonGroup class provides a container to organize groups of button widgets.

QButtonGroup provides an abstract container into which button widgets can be placed. It does not provide a visual representation of this container (see QGroupBox for a container widget), but instead manages the states of each of the buttons in the 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().

See also QGroupBox, 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-tp2