#include <QDS_ComboBox.h>

Inheritance diagram for QDS_ComboBox:

Signals
void	activated (int)
	Emitted when the current item in the combo box is changed. More...

void	activated (const QString &)
	Emitted when the current item in the combo box is changed. 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_ComboBox (const QString &, QWidget *=0, const int=All, const QString &=QString())
	Constructor. More...

virtual	~QDS_ComboBox ()
	Destructor. More...

bool	editable () const
	Check if combo box allows text editing. More...

void	setEditable (const bool)
	Enable/disable text editing. More...

int	count (bool=false) const
	Get number of items in the combo box. More...

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

virtual int	integerValue () const
	Get the current item ID as integer value. More...

virtual double	doubleValue () const
	Get the current item ID as double value. More...

virtual void	setIntegerValue (const int)
	Set the current item acording to the specified id. More...

virtual void	setDoubleValue (const double)
	Set the current item acording to the specified id.This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Integer part of val is used as new current ID. More...

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

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

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

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

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

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

virtual void	reset ()
	Reset the datum. More...

int	stringToValue (const QString &) const
	Convert string to integer value. More...

QString	valueToString (const int) const
	Convert integer to string value. 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...

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

virtual bool	isEmpty () const
	Check if the datum is empty. 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 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	onActivated (int)
	Called when combo box item is activated. More...

virtual void	onTextChanged (const QString &)
	Called when text in the combo box (editable) is modified by the user. More...

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

Protected Member Functions
QtxComboBox *	comboBox () const
	Get combo box widget. More...

virtual QWidget *	createControl (QWidget *)
	Create internal combo box as control widget. More...

virtual void	setString (const QString &)
	Set the string value to the combo 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, QPixmap >	IdIconsMap

typedef QMap< int, QString >	IdValueMap

typedef QMap< int, bool >	IdStateMap

typedef QMap< int, int >	IdIndexMap

Private Member Functions
int	getId (const int) const
	Get item identifier according to the specified index. More...

int	getId (const QString &) const
	Get item identifier. More...

int	getIndex (const int) const
	Get index of the combo box item according to its identifier. More...

int	getIndex (const QString &) const
	Get index of the combo box item. More...

void	updateComboBox ()
	Update combo box. More...

Private Attributes
IdValueMap	myValue

IdStateMap	myState

IdIndexMap	myIndex

IdIconsMap	myIcons

QIntList	myDataIds

QIntList	myUserIds

QStringList	myUserNames

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, QPixmap> QDS_ComboBox::IdIconsMap

private

typedef QMap<int, int> QDS_ComboBox::IdIndexMap

private

typedef QMap<int, bool> QDS_ComboBox::IdStateMap

private

typedef QMap<int, QString> QDS_ComboBox::IdValueMap

private

Constructor & Destructor Documentation

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

Create combobox 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_ComboBox::~QDS_ComboBox ( )

virtual

Member Function Documentation

void QDS_ComboBox::activated ( int id )

signal

Parameters

id	current item ID

void QDS_ComboBox::activated ( const QString & txt )

signal

Parameters

txt	current item text

QtxComboBox * QDS_ComboBox::comboBox ( ) const

protected

Returns: internal combo box widget

References QDS_Datum::controlWidget().

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

Parameters

total if false, only visible items are taken into account, otherwise get total number of items

Returns: number of items

References comboBox(), and myValue.

QWidget * QDS_ComboBox::createControl ( QWidget * parent )

protectedvirtual

Parameters

parent parent widget

Returns: created combo box widget

Implements QDS_Datum.

References activated(), onActivated(), and onTextChanged().

double QDS_ComboBox::doubleValue ( ) const

virtual

Returns: current item ID converted to double

Reimplemented from QDS_Datum.

References comboBox(), getId(), getString(), and QDS_Datum::initDatum().

bool QDS_ComboBox::editable ( ) const

Returns: true if combo box is editable

References comboBox().

int QDS_ComboBox::getId ( const int idx ) const

private

Parameters

idx	item index

Returns: item ID or -1 if index is out of range

References QDS_Datum::id(), and myIndex.

int QDS_ComboBox::getId ( const QString & str ) const

private

Parameters

str	combo box item

Returns: item ID or -1 if not found

References QDS_Datum::id(), myValue, and state().

int QDS_ComboBox::getIndex ( const int id ) const

private

Parameters

id item ID

Returns: item index or -1 if not found

References myIndex.

int QDS_ComboBox::getIndex ( const QString & str ) const

private

Parameters

str	combo box item

Returns: item index or -1 if not found

References comboBox().

QString QDS_ComboBox::getString ( ) const

virtual

Returns: string value

Implements QDS_Datum.

References comboBox(), and QtxComboBox::isCleared().

int QDS_ComboBox::integerValue ( ) const

virtual

Returns: current item ID converted to integer

Reimplemented from QDS_Datum.

References comboBox(), getId(), and getString().

void QDS_ComboBox::onActivated ( int idx )

protectedvirtualslot

Parameters

idx	index of teh item being activated

References activated(), comboBox(), getId(), getString(), QDS_Datum::onParamChanged(), and QDS_Datum::paramChanged().

void QDS_ComboBox::onTextChanged ( const QString & )

protectedvirtualslot

Parameters

txt	current text in the combo box editor (not used)

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

void QDS_ComboBox::reset ( )

virtual

Set the active item as item with default ID. If default ID is not defined then the first item is used.

Reimplemented from QDS_Datum.

References QDS_Datum::defaultValue(), getId(), setIntegerValue(), and setString().

void QDS_ComboBox::setDoubleValue ( const double val )

virtual

Parameters

val item ID

Reimplemented from QDS_Datum.

References QDS_Datum::initDatum(), myValue, and setString().

void QDS_ComboBox::setEditable ( const bool on )

Parameters

on	if `true`, combo box is made editable

References comboBox(), and QDS_Datum::validator().

void QDS_ComboBox::setIntegerValue ( const int id )

virtual

Parameters

id item ID

Reimplemented from QDS_Datum.

References QDS_Datum::initDatum(), myValue, and setString().

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

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

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

Parameters

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

References myState.

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

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

Parameters

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

References QDS_Datum::initDatum(), myState, and updateComboBox().

void QDS_ComboBox::setString ( const QString & txt )

protectedvirtual

Parameters

txt	string value

Implements QDS_Datum.

References activated(), comboBox(), getString(), integerValue(), QtxComboBox::isCleared(), QDS_Datum::onParamChanged(), QDS_Datum::paramChanged(), and QtxComboBox::setCleared().

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

User items like standard dictionary list items will be added into the combobox. This function allows user to override items.

Parameters

ids	items IDs
names	items names

References QDS_Datum::initDatum(), myUserIds, and myUserNames.

void QDS_ComboBox::setValues ( const QStringList & names )

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

Parameters

names items names

References QDS_Datum::initDatum(), and setValues().

bool QDS_ComboBox::state ( const int id ) const

Parameters

id item ID

Returns: item visibility state

References myState.

int QDS_ComboBox::stringToValue ( const QString & str ) const

Parameters

str item

Returns: item ID or -1 if not found

References getId().

void QDS_ComboBox::unitSystemChanged ( const QString & system )

protectedvirtual

Update combobox contents.

Parameters

system new active units system

Reimplemented from QDS_Datum.

References aDicItem, QDS_Datum::Handle(), myDataIds, myIcons, myState, myUserIds, myUserNames, myValue, QDS::toQString(), QDS_Datum::unitSystemChanged(), and updateComboBox().

void QDS_ComboBox::updateComboBox ( )

private

References comboBox(), getId(), getIndex(), QDS_Datum::id(), QtxComboBox::isCleared(), myDataIds, myIcons, myIndex, myState, myValue, and onActivated().

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

Parameters

ids	returned list of items IDs
total	if `false`, only visible items are taken into account, otherwise get total number of items

References myDataIds, and myState.

QString QDS_ComboBox::valueToString ( const int val ) const

Parameters

val item ID

Returns: item value or empty string if val is invalid

References myValue.

Member Data Documentation

QIntList QDS_ComboBox::myDataIds

private

IdIconsMap QDS_ComboBox::myIcons

private

IdIndexMap QDS_ComboBox::myIndex

private

IdStateMap QDS_ComboBox::myState

private

QIntList QDS_ComboBox::myUserIds

private

QStringList QDS_ComboBox::myUserNames

private

IdValueMap QDS_ComboBox::myValue

private

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

src/QDS/QDS_ComboBox.h
src/QDS/QDS_ComboBox.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