#include <QDS_RadioBox.h>

Inheritance diagram for QDS_RadioBox:

Signals
void	activated (int)
	The signal is emitted when any radio button is toggled. More...

Signals inherited from QDS_Datum
void	paramChanged ()
	The signal is emitted when the datum value is changed. More...

void	paramChanged (QString &)

Public Member Functions
	QDS_RadioBox (const QString &, QWidget *=0, const int=Control, const QString &=QString())
	Constructor. More...

virtual	~QDS_RadioBox ()
	Destructor. More...

int	count (bool=false) const
	Get number of buttons in radio box. More...

void	values (QList< int > &, bool=false) const
	Get buttons identifiers. More...

int	columns () const

void	setColumns (const int)

bool	state (const int) const
	Get visibility state of the button specified by id. More...

void	setState (const bool, const int, const bool=true)
	Set the visibility state of the button specified by id. More...

void	setState (const bool, const QList< int > &, const bool=true)
	Set the visibility state of buttons specified by ids. More...

void	setValues (const QList< int > &, const QStringList &)
	Set the custom user buttons into the radio box. More...

void	setValues (const QStringList &)
	Set the custom user buttons into the radio box.This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. User buttons like standard dictionary buttons will be added into the radio box. This function allows user to customize buttons. More...

virtual QString	getString () const
	Get string from the radio box. More...

Public Member Functions inherited from QDS_Datum
	QDS_Datum (const QString &, QWidget *=0, const int=All, const QString &=QString())
	Constructor. More...

virtual	~QDS_Datum ()
	Destructor. More...

QString	id () const
	Get the datum ID. More...

int	type () const
	Get the datum value type. More...

QString	label () const
	Get the datum label text. More...

QString	units () const
	Get the datum units text. More...

QString	filter () const
	Get the datum filter string. More...

QString	format () const
	Get the datum format string. More...

QString	longDescription () const
	Get the datum long description. More...

QString	shortDescription () const
	Get the datum short description. More...

QString	defaultValue () const
	Get the datum default value. More...

QString	minimumValue () const
	Get the datum minimum value. More...

QString	maximumValue () const
	Get the datum maximum value. More...

QStringList	options () const
	Get the datum options names. More...

QVariant	option (const QString &) const
	Get datum option specified by name as QVariant. More...

QString	optionString (const QString &) const
	Get datum option specified by name as string. More...

double	optionDouble (const QString &) const
	Get datum option specified by name as double. More...

int	optionInteger (const QString &) const
	Get datum option specified by name as integer. More...

virtual QVariant	value () const
	Get the datum value as QVariant. More...

virtual QString	stringValue () const
	Get the datum value as string. More...

virtual double	doubleValue () const
	Get the datum value as double. More...

virtual int	integerValue () const
	Get the datum value as integer. More...

QString	text () const
	Get the text data from datum. More...

virtual bool	isEmpty () const
	Check if the datum is empty. More...

virtual void	reset ()
	Reset datum state and set default value as current. More...

virtual void	clear ()
	Clear the control. More...

virtual void	setValue (const QVariant &)
	Set datum value from QVariant object. More...

virtual void	setStringValue (const QString &)
	Set datum value from string data. More...

virtual void	setDoubleValue (const double)
	Set datum value from double data. More...

virtual void	setIntegerValue (const int)
	Set datum value from integer data. More...

virtual bool	isEnabled (const int=Control) const
	Get 'enabled' state of the specified subwidget. More...

virtual void	setEnabled (const bool, const int)
	Enable/disable subwidgets specified by element. More...

void	show (const int=All)
	Show subwidgets specified by element. More...

void	hide (const int=All)
	Hide subwidgets specified by element. More...

virtual void	setShown (const bool, const int=All)
	Show/hide subwidgets specified by flags. More...

QWidget *	widget (const int) const
	Get subwidget specified by element. More...

void	setFocus ()
	Set the input focus to the control widget. More...

virtual bool	isValid (const bool=true, const QString &=QString(), const QString &=QString()) const
	Check if input data is valid. More...

virtual QValidator *	validator (const bool=false) const
	Create validator according to the datum type of value. More...

void	addTo (QVBoxLayout *)
	Add widgets to the vertical box layout. More...

void	addTo (QHBoxLayout *)
	Add widgets to the horizontal box layout. More...

void	addTo (QGridLayout *, const int, const int, const bool=false)
	Add widgets to the grid layout. More...

virtual void	setAlignment (const int, const int=Label)
	Set the aligment for QDS::Label and/or QDS::Units subwidgets. More...

virtual bool	eventFilter (QObject , QEvent )
	Event filter. More...

	operator QWidget * () const
	Overloaded operator used to retrieve main subwidget named QDS::Control. More...

bool	isCustomTr () const
	Return state of custom translation. More...

void	enableCustomTr (const bool)
	Change state of custom translation. More...

Protected Slots
virtual void	onToggled (bool)
	Called when user toggles any radio button. More...

Protected Slots inherited from QDS_Datum
virtual void	onParamChanged ()
	Called when datum value is changed. More...

Protected Member Functions
QButtonGroup *	buttonGroup () const
	Get internal button group. More...

QGroupBox *	groupBox () const
	Get internal group box widget. More...

virtual QWidget *	createControl (QWidget *)
	Get radio button group box widget. More...

void	buttons (QList< QRadioButton * > &) const
	Get all the radio buttons from the radio box. More...

virtual void	setString (const QString &)
	Set the string value to the radio box widget. More...

virtual void	unitSystemChanged (const QString &)
	Process notification about active units system changing. More...

Protected Member Functions inherited from QDS_Datum
QLabel *	labelWidget () const
	Get QDS::Label widget. More...

QLabel *	unitsWidget () const
	Get QDS::Units widget. More...

QWidget *	controlWidget () const
	Get QDS::Control widget. More...

	Handle (DDS_DicItem) dicItem() const

void	setDicItem (const Handle(DDS_DicItem)&)

int	flags () const
	Get datum flags. More...

void	invalidateCache ()
	Reset the numeric value cache. More...

virtual QLabel *	createLabel (QWidget *)
	Create QDS::Label widget. More...

virtual QLabel *	createUnits (QWidget *)
	Create QDS::Units widget. More...

virtual bool	validate (const QString &) const
	Validate the specified string. More...

QString	prefix () const
	Get prefix string from format. More...

QString	suffix () const
	Get suffix string from format. More...

virtual QString	minValue () const
	Get minimum value. More...

virtual QString	maxValue () const
	Get maximum value. More...

void	initDatum () const
	Perform initialization if it needed. More...

Private Types
typedef QMap< int, QString >	IdValueMap

typedef QMap< int, bool >	IdStateMap

Private Member Functions
void	updateRadioBox ()
	Update radio box. More...

Private Attributes
IdValueMap	myValue

IdStateMap	myState

QIntList	myDataIds

QIntList	myUserIds

QStringList	myUserNames

QButtonGroup *	myButtonGroup

Additional Inherited Members
Public Types inherited from QDS
enum	DatumFlags { None = 0x00, Label = 0x01, Control = 0x02, Units = 0x04, NotFormat = 0x08, NotAccel = 0x10, NotConvert = 0x20, UnitsWithLabel = 0x40, All = Label \| Control \| Units }
	Enum describes bit flags of the Qt datum view and behaviour. More...

Public Slots inherited from QDS_Datum
void	setEnabled (bool)
	Enable/disable main control subwidget (QDS::Control). More...

Static Public Member Functions inherited from QDS_Datum
static QString	unitsToText (const QString &)
	Convert units into text presentation. More...

static QString	textToUnits (const QString &)
	Convert text presentation into internal units format. More...

static QString	format (const QString &, const QString &, const bool=false)
	Format the specified string as dictionary item value. More...

static QString	format (const int, const QString &, const bool=false)
	Format the specified integer as dictionary item value. More...

static QString	format (const double, const QString &, const bool=false)
	Format the specified double as dictionary item value. More...

static QString	units (const QString &)
	Get displayable units string for specified data dictionary item. More...

Static Protected Member Functions inherited from QDS_Datum
static QString	format (const QString &, const int, const int)
	Format the given value according to the data dictionary item type. More...

static QString	format (const QString &, const int, const double)
	Format the given value according to the data dictionary item type. More...

static QString	format (const QString &, const int, const QString &)
	Format the given value according to the data dictionary item type. More...

static QString	sprintf (const QString &, const int)
	Wrapper around the standard sprintf() function. More...

static QString	sprintf (const QString &, const double)
	Wrapper around the standard sprintf() function.This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Process some non standard flags from format string. More...

static QString	sprintf (const QString &, const QString &)
	Wrapper around the standard sprintf() function.This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Process some non standard flags from format string. More...

Member Typedef Documentation

typedef QMap<int, bool> QDS_RadioBox::IdStateMap

private

typedef QMap<int, QString> QDS_RadioBox::IdValueMap

private

Constructor & Destructor Documentation

QDS_RadioBox::QDS_RadioBox	(	const QString &	id,
		QWidget *	parent = `0`,
		const int	flags = `Control`,
		const QString &	comp = `QString()`
	)

Create radio button box datum object with datum identifier id and parent widget parent.

Parameter flags defines behaviour of datum and set of created subwidgets. Default value of this parameter is QDS::All.

Parameter comp specifies the component name which will be used when searching the dictionary item.

Parameters

id	datum identifier
parent	parent widget
flags	datum flags
comp	component

QDS_RadioBox::~QDS_RadioBox ( )

virtual

Member Function Documentation

void QDS_RadioBox::activated ( int id )

signal

Parameters

id button ID

QButtonGroup * QDS_RadioBox::buttonGroup ( ) const

protected

Returns: pointer to the QButtonGroup object

References myButtonGroup.

void QDS_RadioBox::buttons ( QList< QRadioButton * > & lst ) const

protected

Parameters

lst	returned list of radio buttons

References buttonGroup().

int QDS_RadioBox::columns ( ) const

int QDS_RadioBox::count ( bool total = false ) const

If total is false, only visible buttons are taken into account; otherwise total number of buttons is returned

Parameters

total get number of visible buttons if true and total number of buttons if false

Returns: requested number of items

References buttons(), and myValue.

QWidget * QDS_RadioBox::createControl ( QWidget * parent )

protectedvirtual

Returns: internal group box widget

Implements QDS_Datum.

References myButtonGroup.

QString QDS_RadioBox::getString ( ) const

virtual

String which contains identifier of the currently selected button is returned.

Returns: identifier of the current button converted to string

Implements QDS_Datum.

References buttonGroup().

QGroupBox * QDS_RadioBox::groupBox ( ) const

protected

Returns: pointer to the QGroupBox widget

References QDS_Datum::controlWidget().

void QDS_RadioBox::onToggled ( bool on )

protectedvirtualslot

Parameters

on	new radio button state

References getString(), QDS_Datum::onParamChanged(), and QDS_Datum::paramChanged().

void QDS_RadioBox::setColumns ( const int )

void QDS_RadioBox::setState	(	const bool	on,
		const int	id,
		const bool	append = `true`
	)

If id is -1 then specified state will be set to all buttons.

If append is set to true, keep current status for other buttons, otherwise status of other buttons is cleared.

Parameters

on	new visibility state
id	button ID
append	if `true`, keep original status for other buttons

References myState.

void QDS_RadioBox::setState	(	const bool	on,
		const QList< int > &	ids,
		const bool	append = `true`
	)

If append is set to true, keep the current status for other buttons, otherwise status of other buttons is cleared.

Parameters

on	new visibility state
ids	buttons IDs list
append	if `true`, keep original status for other buttons

References myState, and updateRadioBox().

void QDS_RadioBox::setString ( const QString & txt )

protectedvirtual

Button with the identifier from specified string txt becomes selected in the radio box.

Parameters

txt	string value

Implements QDS_Datum.

References activated(), buttonGroup(), buttons(), getString(), QDS_Datum::onParamChanged(), and QDS_Datum::paramChanged().

void QDS_RadioBox::setValues	(	const QList< int > &	ids,
		const QStringList &	names
	)

User items like standard dictionary buttons will be added into the radio box. This function allows user to customize buttons.

Parameters

ids	buttons IDs
names	buttons names

References myUserIds, and myUserNames.

void QDS_RadioBox::setValues ( const QStringList & names )

Uses (0, 1, 2 ... ) as buttons IDs.

Parameters

names buttons names

References setValues().

bool QDS_RadioBox::state ( const int id ) const

Parameters

id button ID

Returns: item visibility state

References myState.

void QDS_RadioBox::unitSystemChanged ( const QString & system )

protectedvirtual

Update radio box contents.

Parameters

system new active units system

Reimplemented from QDS_Datum.

References aDicItem, groupBox(), QDS_Datum::Handle(), QDS_Datum::label(), myDataIds, myState, myUserIds, myUserNames, myValue, QDS::toQString(), QDS_Datum::unitSystemChanged(), and updateRadioBox().

void QDS_RadioBox::updateRadioBox ( )

private

References buttonGroup(), buttons(), getString(), groupBox(), QDS_Datum::id(), myDataIds, myState, myValue, QDS_Datum::onParamChanged(), onToggled(), and QDS_Datum::paramChanged().

void QDS_RadioBox::values	(	QList< int > &	ids,
		bool	total = `false`
	)		const

Parameters

ids	returned list of buttons IDs
total	take into account only visible buttons if `true` and all buttons if `false`

References myDataIds, and myState.

Member Data Documentation

QButtonGroup* QDS_RadioBox::myButtonGroup

private

QIntList QDS_RadioBox::myDataIds

private

IdStateMap QDS_RadioBox::myState

private

QIntList QDS_RadioBox::myUserIds

private

QStringList QDS_RadioBox::myUserNames

private

IdValueMap QDS_RadioBox::myValue

private

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

src/QDS/QDS_RadioBox.h
src/QDS/QDS_RadioBox.cxx

Signals

Public Member Functions

Protected Slots

Protected Member Functions

Private Types

Private Member Functions

Private Attributes

Additional Inherited Members

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation