#include <QDS_ComboBox.h>

Inheritance diagram for QDS_ComboBox:

Public Types
enum	DatumFlags { None = 0x00, Label = 0x01, Control = 0x02, Units = 0x04, NotFormat = 0x08, NotAccel = 0x10, UnitsWithLabel = 0x20, All = Label \| Control \| Units }
	Enum describes bit flags of the Qt datum view and behaviour. More...
Public Slots
void	setEnabled (bool)
	Enable/disable main control subwidget (QDS.Control).
Signals
void	activated (int)
	Emitted when the current item in the combo box is changed.
void	activated (const QString &)
	Emitted when the current item in the combo box is changed.
void	paramChanged ()
	The signal is emitted when the datum value is changed.
void	paramChanged (QString &)
Public Member Functions
	QDS_ComboBox (const QString &, QWidget *=0, const int=All, const QString &=QString())
	Constructor.
virtual	~QDS_ComboBox ()
	Destructor.
bool	editable () const
	Check if combo box allows text editing.
void	setEditable (const bool)
	Enable/disable text editing.
int	count (bool=false) const
	Get number of items in the combo box.
void	values (QList< int > &, bool=false) const
	Get items identifiers.
virtual int	integerValue () const
	Get the current item ID as integer value.
virtual double	doubleValue () const
	Get the current item ID as double value.
virtual void	setIntegerValue (const int)
	Set the current item acording to the specified id.
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.
bool	state (const int) const
	Get visibility state of the item specified by id.
void	setState (const bool, const int, const bool=true)
	Set the visibility state of the item specified by id.
void	setState (const bool, const QList< int > &, const bool=true)
	Set the visibility state of items specified by ids.
void	setValues (const QList< int > &, const QStringList &)
	Set the custom user items into the combo box.
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.
virtual void	reset ()
	Reset the datum.
int	stringToValue (const QString &) const
	Convert string to integer value.
QString	valueToString (const int) const
	Convert integer to string value.
QString	id () const
	Get the datum ID.
int	type () const
	Get the datum value type.
QString	label () const
	Get the datum label text.
QString	units () const
	Get the datum units text.
QString	filter () const
	Get the datum filter string.
QString	format () const
	Get the datum format string.
QString	longDescription () const
	Get the datum long description.
QString	shortDescription () const
	Get the datum short description.
QString	defaultValue () const
	Get the datum default value.
QString	minimumValue () const
	Get the datum minimum value.
QString	maximumValue () const
	Get the datum maximum value.
QStringList	options () const
	Get the datum options names.
QVariant	option (const QString &) const
	Get datum option specified by name as QVariant.
QString	optionString (const QString &) const
	Get datum option specified by name as string.
double	optionDouble (const QString &) const
	Get datum option specified by name as double.
int	optionInteger (const QString &) const
	Get datum option specified by name as integer.
virtual QVariant	value () const
	Get the datum value as QVariant.
virtual QString	stringValue () const
	Get the datum value as string.
QString	text () const
	Get the text data from datum.
virtual bool	isEmpty () const
	Check if the datum is empty.
virtual void	clear ()
	Clear the control.
virtual void	setValue (const QVariant &)
	Set datum value from QVariant object.
virtual void	setStringValue (const QString &)
	Set datum value from string data.
virtual bool	isEnabled (const int=Control) const
	Get 'enabled' state of the specified subwidget.
virtual void	setEnabled (const bool, const int)
	Enable/disable subwidgets specified by element.
void	show (const int=All)
	Show subwidgets specified by element.
void	hide (const int=All)
	Hide subwidgets specified by element.
virtual void	setShown (const bool, const int=All)
	Show/hide subwidgets specified by flags.
QWidget *	widget (const int) const
	Get subwidget specified by element.
void	setFocus ()
	Set the input focus to the control widget.
virtual bool	isValid (const bool=true, const QString &=QString(), const QString &=QString()) const
	Check if input data is valid.
virtual QValidator *	validator (const bool=false) const
	Create validator according to the datum type of value.
void	addTo (QVBoxLayout *)
	Add widgets to the vertical box layout.
void	addTo (QHBoxLayout *)
	Add widgets to the horizontal box layout.
void	addTo (QGridLayout *, const int, const int, const bool=false)
	Add widgets to the grid layout.
virtual void	setAlignment (const int, const int=Label)
	Set the aligment for QDS.Label and/or QDS.Units subwidgets.
virtual bool	eventFilter (QObject , QEvent )
	Event filter.
	operator QWidget * () const
	Overloaded operator used to retrieve main subwidget named QDS.Control.
bool	isCustomTr () const
	Return state of custom translation.
void	enableCustomTr (const bool)
	Change state of custom translation.
Static Public Member Functions
static QString	units (const QString &)
	Get displayable units string for specified data dictionary item.
static QString	format (const QString &, const QString &, const bool=false)
	Format the specified string as dictionary item value.
static QString	format (const int, const QString &, const bool=false)
	Format the specified integer as dictionary item value.
static QString	format (const double, const QString &, const bool=false)
	Format the specified double as dictionary item value.
static QString	unitsToText (const QString &)
	Convert units into text presentation.
static QString	textToUnits (const QString &)
	Convert text presentation into internal units format.
static bool	load (const QString &)
	Load datum definitions from XML file dictPath to the dictionary.
static QString	unitSystemLabel (const QString &, const QString &=QString())
	Get the label of unit system sys.
static QString	activeUnitSystem (const QString &=QString())
	Get the name of active unit system from the specified component comp.
static void	setActiveUnitSystem (const QString &, const QString &=QString())
	Set the active unit system.
static QString	toQString (const TCollection_AsciiString &)
	Convert the OpenCascade ASCII string to Qt string.
static QString	toQString (const TCollection_ExtendedString &)
	Convert the OpenCascade Unicode string to Qt string.
static QString	toQString (const Handle(TCollection_HAsciiString)&)
	Convert the OpenCascade ASCII string to Qt string.
static QString	toQString (const Handle(TCollection_HExtendedString)&)
	Convert the OpenCascade Unicode string to Qt string.
static TCollection_AsciiString	toAsciiString (const QString &)
	Convert the Qt string to OpenCascade ASCII string.
static TCollection_AsciiString	toAsciiString (const TCollection_ExtendedString &)
	Convert the OpenCascade Unicode string to OpenCascade ASCII string.
static TCollection_AsciiString	toAsciiString (const Handle(TCollection_HExtendedString)&)
	Convert the OpenCascade Unicode string to OpenCascade ASCII string.
static TCollection_ExtendedString	toExtString (const QString &)
	Convert the Qt string to OpenCascade Unicode string.
static TCollection_ExtendedString	toExtString (const TCollection_AsciiString &)
	Convert the OpenCascade ASCII string to OpenCascade Unicode string.
Protected Slots
virtual void	onActivated (int)
	Called when combo box item is activated.
virtual void	onTextChanged (const QString &)
	Called when text in the combo box (editable) is modified by the user.
virtual void	onParamChanged ()
	Called when datum value is changed.
Protected Member Functions
QtxComboBox *	comboBox () const
	Get combo box widget.
virtual QWidget *	createControl (QWidget *)
	Create internal combo box as control widget.
virtual QString	getString () const
	Get string from the combo box.
virtual void	setString (const QString &)
	Set the string value to the combo box widget.
virtual void	unitSystemChanged (const QString &)
	Process notification about active units system changing.
QLabel *	labelWidget () const
	Get QDS.Label widget.
QLabel *	unitsWidget () const
	Get QDS.Units widget.
QWidget *	controlWidget () const
	Get QDS.Control widget.
	Handle (DDS_DicItem) dicItem() const
void	setDicItem (const Handle(DDS_DicItem)&)
	Set the dictionary item to the datum.
int	flags () const
	Get datum flags.
void	invalidateCache ()
	Reset the numeric value cache.
virtual QLabel *	createLabel (QWidget *)
	Create QDS.Label widget.
virtual QLabel *	createUnits (QWidget *)
	Create QDS.Units widget.
virtual bool	validate (const QString &) const
	Validate the specified string.
QString	prefix () const
	Get prefix string from format.
QString	suffix () const
	Get suffix string from format.
virtual QString	minValue () const
	Get minimum value.
virtual QString	maxValue () const
	Get maximum value.
void	initDatum () const
	Perform initialization if it needed.
Static Protected Member Functions
static QString	format (const QString &, const int, const int)
	Format the given value according to the data dictionary item type.
static QString	format (const QString &, const int, const double)
	Format the given value according to the data dictionary item type.
static QString	format (const QString &, const int, const QString &)
	Format the given value according to the data dictionary item type.
static QString	sprintf (const QString &, const int)
	Wrapper around the standard sprintf() function.
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.
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.
static void	insertDatum (QDS_Datum *)
	Register given datum datum in the global list.
static void	removeDatum (QDS_Datum *)
	Remove given datum datum from the global list.
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.
int	getId (const QString &) const
	Get item identifier.
int	getIndex (const int) const
	Get index of the combo box item according to its identifier.
int	getIndex (const QString &) const
	Get index of the combo box item.
void	updateComboBox ()
	Update combo box.
Private Attributes
IdValueMap	myValue
IdStateMap	myState
IdIndexMap	myIndex
IdIconsMap	myIcons
QIntList	myDataIds
QIntList	myUserIds
QStringList	myUserNames

Member Typedef Documentation

typedef QMap<int, QPixmap> QDS_ComboBox.IdIconsMap [private]

typedef QMap<int, QString> QDS_ComboBox.IdValueMap [private]

typedef QMap<int, bool> QDS_ComboBox.IdStateMap [private]

typedef QMap<int, int> QDS_ComboBox.IdIndexMap [private]

Member Enumeration Documentation

enum QDS::DatumFlags [inherited]

Enumerator:

None	Non specified any flags (Default behaviour)
Label	Create subwidget for datum label.
Control	Create subwidget for datum input control.
Units	Create subwidget for datum units of measure.
NotFormat	Don't format initial value.
NotAccel	Not support accelerators in datum label.
UnitsWithLabel	Display units of measure in label like "<label_text> (<units_text>) instead separate text".
All	Create all subwidgets.

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

bool QDS_ComboBox::editable ( ) const

Returns:: true if combo box is editable

References comboBox().

void QDS_ComboBox::setEditable ( const bool on )

Parameters:

on	if `true`, combo box is made editable

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

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.

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.

int QDS_ComboBox::integerValue ( ) const [virtual]

Returns:: current item ID converted to integer

Reimplemented from QDS_Datum.

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

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

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::setDoubleValue ( const double val ) [virtual]

Parameters:

val item ID

Reimplemented from QDS_Datum.

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

bool QDS_ComboBox::state ( const int id ) const

Parameters:

id item ID

Returns:: item visibility state

References myState.

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

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

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

Parameters:

str item

Returns:: item ID or -1 if not found

References getId().

QString QDS_ComboBox::valueToString ( const int val ) const

Parameters:

val item ID

Returns:: item value or empty string if val is invalid

References myValue.

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

void QDS_ComboBox::onActivated ( int idx ) [protected, virtual, slot]

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 & ) [protected, virtual, slot]

Parameters:

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

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

QtxComboBox * QDS_ComboBox::comboBox ( ) const [protected]

Returns:: internal combo box widget

References QDS_Datum.controlWidget().

QWidget * QDS_ComboBox::createControl ( QWidget * parent ) [protected, virtual]

Parameters:

parent parent widget

Returns:: created combo box widget

Implements QDS_Datum.

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

QString QDS_ComboBox::getString ( ) const [protected, virtual]

Returns:: string value

Implements QDS_Datum.

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

void QDS_ComboBox::setString ( const QString & txt ) [protected, virtual]

Parameters:

txt	string value

Implements QDS_Datum.

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

void QDS_ComboBox::unitSystemChanged ( const QString & system ) [protected, virtual]

Update combobox contents.

Parameters:

system new active units system

Reimplemented from QDS_Datum.

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

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

void QDS_ComboBox::updateComboBox ( ) [private]

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

QString QDS_Datum::id ( ) const [inherited]

Returns:: datum ID

References QDS_Datum.initDatum(), and QDS_Datum.myId.

int QDS_Datum::type ( ) const [inherited]

Returns:: datum value type

References QDS_Datum.initDatum(), and DDS_DicItem.Unknown.

QString QDS_Datum::label ( ) const [inherited]

Returns:: label text

References QDS_Datum.flags(), QDS_Datum.initDatum(), QDS_Datum.myTr, QDS.NotAccel, QDS_Datum.removeAccel(), and QDS.toQString().

QString QDS_Datum::units ( ) const [inherited]

Returns:: units text

References QDS_Datum.initDatum(), and QDS.toQString().

QString QDS_Datum::units ( const QString & id ) [static, inherited]

Parameters:

id	data dictionary item ID

Returns:: units string

References QDS_Datum.Handle(), QDS.toAsciiString(), QDS.toQString(), and QDS_Datum.unitsToText().

QString QDS_Datum::filter ( ) const [inherited]

Returns:: filter string

References QDS_Datum.initDatum(), and QDS.toQString().

QString QDS_Datum::format ( ) const [inherited]

Returns:: format string

References QDS_Datum.initDatum(), and QDS.toQString().

QString QDS_Datum::format	(	const QString &	str,
		const QString &	id,
		const bool	convert = `false`
	)		`[static, inherited]`

Parameters:

str	string value being formatted
id	data dictionary ID
convert	if `true`, perform conversion from "SI" units system

Returns:: formatted value

References QDS_Datum.format(), QDS_Datum.Handle(), QDS.toAsciiString(), QDS.toQString(), and DDS_DicItem.Unknown.

QString QDS_Datum::format	(	const int	num,
		const QString &	id,
		const bool	convert = `false`
	)		`[static, inherited]`

Parameters:

num	integer value being formatted
id	data dictionary ID
convert	if `true`, perform conversion from "SI" units system

Returns:: formatted value

References QDS_Datum.format(), QDS_Datum.Handle(), QDS.toAsciiString(), QDS.toQString(), and DDS_DicItem.Unknown.

QString QDS_Datum::format	(	const double	num,
		const QString &	id,
		const bool	convert = `false`
	)		`[static, inherited]`

Parameters:

num	double value being formatted
id	data dictionary ID
convert	if `true`, perform conversion from "SI" units system

Returns:: formatted value

References QDS_Datum.format(), QDS_Datum.Handle(), QDS.toAsciiString(), QDS.toQString(), and DDS_DicItem.Unknown.

QString QDS_Datum::format	(	const QString &	aFormat,
		const int	aType,
		const int	aValue
	)		`[static, protected, inherited]`

Parameters:

aFormat	format string
aType	data dictionary item type
aValue	integer value being formatted

Returns:: formatted value

References DDS_DicItem.Float, DDS_DicItem.Integer, QDS_Datum.sprintf(), and DDS_DicItem.String.

QString QDS_Datum::format	(	const QString &	aFormat,
		const int	aType,
		const double	aValue
	)		`[static, protected, inherited]`

Parameters:

aFormat	format string
aType	data dictionary item type
aValue	double value being formatted

Returns:: formatted value

References DDS_DicItem.Float, DDS_DicItem.Integer, and DDS_DicItem.String.

QString QDS_Datum::format	(	const QString &	aFormat,
		const int	aType,
		const QString &	aValue
	)		`[static, protected, inherited]`

Parameters:

aFormat	format string
aType	data dictionary item type
aValue	string value being formatted

Returns:: formatted value

References DDS_DicItem.Float, DDS_DicItem.Integer, QDS_Datum.sprintf(), and DDS_DicItem.String.

QString QDS_Datum::longDescription ( ) const [inherited]

Returns:: datum long description

References QDS_Datum.initDatum(), and QDS.toQString().

QString QDS_Datum::shortDescription ( ) const [inherited]

Returns:: datum short description

References QDS_Datum.initDatum(), and QDS.toQString().

QString QDS_Datum::defaultValue ( ) const [inherited]

Returns:: default value

References QDS_Datum.initDatum(), QDS_Datum.prefix(), QDS_Datum.suffix(), and QDS.toQString().

QString QDS_Datum::minimumValue ( ) const [inherited]

Returns:: minimum value

References QDS_Datum.format(), QDS_Datum.initDatum(), DDS_DicItem.MinValue, and QDS_Datum.type().

QString QDS_Datum::maximumValue ( ) const [inherited]

Returns:: maximum value

References QDS_Datum.format(), QDS_Datum.initDatum(), DDS_DicItem.MaxValue, and QDS_Datum.type().

QStringList QDS_Datum::options ( ) const [inherited]

Returns:: datum options

References QDS.toQString().

QVariant QDS_Datum::option ( const QString & name ) const [inherited]

Returns:: the option value or invalid QVariant if the option does not exist

References QDS.toAsciiString(), and QDS.toQString().

QString QDS_Datum::optionString ( const QString & name ) const [inherited]

Returns:: the option value or null QString if the option does not exist

References QDS.toAsciiString(), and QDS.toQString().

double QDS_Datum::optionDouble ( const QString & name ) const [inherited]

Returns:: the option value or 0 if the option does not exist

References QDS_Datum.option().

int QDS_Datum::optionInteger ( const QString & name ) const [inherited]

Returns:: the option value or 0 if the option does not exist

References QDS_Datum.option().

QVariant QDS_Datum::value ( ) const [virtual, inherited]

Returns:: datum value

References QDS_Datum.isEmpty(), and QDS_Datum.stringValue().

QString QDS_Datum::stringValue ( ) const [virtual, inherited]

Returns:: datum value converted to string

References QDS_Datum.getString(), QDS_Datum.initDatum(), QDS_Datum.mySourceValue, and QDS_Datum.myTargetValue.

QString QDS_Datum::text ( ) const [inherited]

Text consists of label, string value and units.

Returns:: datum text data

References QDS_Datum.initDatum(), QDS_Datum.label(), QDS_Datum.stringValue(), and QDS_Datum.units().

bool QDS_Datum::isEmpty ( ) const [virtual, inherited]

Returns:: false if datum control has value entered

References QDS_Datum.stringValue().

void QDS_Datum::clear ( ) [virtual, inherited]

Reimplemented in QDS_CheckBox.

References QDS_Datum.getString(), QDS_Datum.initDatum(), QDS_Datum.invalidateCache(), QDS_Datum.isEmpty(), QDS_Datum.mySourceValue, QDS_Datum.onParamChanged(), QDS_Datum.paramChanged(), and QDS_Datum.setString().

void QDS_Datum::setValue ( const QVariant & val ) [virtual, inherited]

Parameters:

val new value

References QDS_Datum.clear(), and QDS_Datum.setStringValue().

void QDS_Datum::setStringValue ( const QString & txt ) [virtual, inherited]

Parameters:

txt new value

References QDS_Datum.flags(), QDS_Datum.format(), QDS_Datum.getString(), QDS_Datum.initDatum(), QDS_Datum.mySourceValue, QDS_Datum.myTargetValue, QDS.NotFormat, QDS_Datum.onParamChanged(), QDS_Datum.paramChanged(), QDS_Datum.setString(), and QDS_Datum.type().

bool QDS_Datum::isEnabled ( const int element = Control ) const [virtual, inherited]

Parameters:

element ORed subwidget flags (QDS.DatumFlags)

Returns:: true if all subwidgets specified by element are enabled

See also:: setEnabled()

References QDS.Control, QDS_Datum.controlWidget(), QDS_Datum.initDatum(), QDS.Label, QDS_Datum.labelWidget(), QDS.Units, and QDS_Datum.unitsWidget().

void QDS_Datum::setEnabled	(	const bool	on,
		const int	element
	)		`[virtual, inherited]`

Possible values of element: QDS.Label, QDS.Control, QDS.Units or their ORed combinations.

Parameters:

on	new 'enabled' state
element	ORed subwidget flags (QDS.DatumFlags)

See also:: isEnabled()

References QDS.Control, QDS_Datum.controlWidget(), QDS_Datum.initDatum(), QDS.Label, QDS_Datum.labelWidget(), QDS.Units, and QDS_Datum.unitsWidget().

void QDS_Datum::setEnabled ( bool on ) [slot, inherited]

Parameters:

on	new 'enabled' state

References QDS.Control, and QDS_Datum.setEnabled().

void QDS_Datum::show ( const int element = All ) [inherited]

Possible values of element: QDS.Label, QDS.Control, QDS.Units or their ORed combinations.

Parameters:

element ORed subwidget flags (QDS.DatumFlags)

See also:: hide(), setShown()

References QDS_Datum.setShown().

void QDS_Datum::hide ( const int element = All ) [inherited]

Possible values of element: QDS.Label, QDS.Control, QDS.Units or their ORed combinations.

Parameters:

element ORed subwidget flags (QDS.DatumFlags)

See also:: show(), setShown()

References QDS_Datum.setShown().

void QDS_Datum::setShown	(	const bool	visible,
		const int	flags = `All`
	)		`[virtual, inherited]`

Possible values of flags: QDS.Label, QDS.Control, QDS.Units or their ORed combinations.

Parameters:

visible	new 'visibility' state
flags	ORed subwidget flags (QDS.DatumFlags)

See also:: show(), hide()

References QDS_Datum.initDatum(), QDS.Units, and QDS_Datum.widget().

QWidget * QDS_Datum::widget ( const int element ) const [inherited]

Possible values of element: QDS.Label, QDS.Control, QDS.Units.

Parameters:

element subwidget

Returns:: widget

References QDS_Datum.initDatum(), and QDS_Datum.wrapper().

void QDS_Datum::setFocus ( ) [inherited]

References QDS_Datum.controlWidget(), and QDS_Datum.initDatum().

bool QDS_Datum::isValid	(	const bool	msgBox = `true`,
		const QString &	extMsg = `QString()`,
		const QString &	extLabel = `QString()`
	)		const `[virtual, inherited]`

If data is invalid and msgBox is true, the warning message box is shown.

Parameters:

msgBox	if `true`, show warning message box if input is invalid
extMsg	warning message
extLabel	optional name of the variable (if QDS.Label control is not used)

Returns:: true if input data is valid

References QDS_Datum.controlWidget(), DDS_DicItem.Float, QDS_Datum.format(), QDS_Datum.getString(), QDS_Datum.initDatum(), DDS_DicItem.Integer, QDS_Datum.isDoubleFormat(), QDS_Datum.isEmpty(), QDS_Datum.label(), QDS_Datum.maxValue(), QDS_Datum.minValue(), DDS_DicItem.String, QDS.toQString(), QDS_Datum.type(), and QDS_Datum.validate().

QValidator * QDS_Datum::validator ( const bool limits = false ) const [virtual, inherited]

Parameters:

limits if true use minimum and maximum value limits

Returns:: validator

References QDS_Datum.canonicalFormat(), QDS_Datum.filter(), DDS_DicItem.Float, QDS_Datum.format(), DDS_DicItem.Integer, QDS_Datum.maxValue(), QDS_Datum.minValue(), QDS_StringValidator.setLength(), DDS_DicItem.String, and QDS_Datum.type().

void QDS_Datum::addTo ( QVBoxLayout * l ) [inherited]

Parameters:

l layout

References QDS.Control, QDS_Datum.initDatum(), QDS.Label, QDS.Units, and QDS_Datum.wrapper().

void QDS_Datum::addTo ( QHBoxLayout * l ) [inherited]

Parameters:

l layout

References QDS.Control, QDS_Datum.initDatum(), QDS.Label, QDS.Units, QDS_Datum.unitsWidget(), and QDS_Datum.wrapper().

void QDS_Datum::addTo	(	QGridLayout *	theLay,
		const int	theRow,
		const int	theCol,
		const bool	vertical = `false`
	)		`[inherited]`

Parameters:

theLay	layout
theRow	layout row index
theCol	layout column index
vertical	if `true` subwidgets are layouted vertically, otherwise - horizontally

References QDS.Control, QDS_Datum.initDatum(), QDS.Label, QDS.Units, and QDS_Datum.wrapper().

void QDS_Datum::setAlignment	(	const int	align,
		const int	type = `Label`
	)		`[virtual, inherited]`

Parameters:

align	alignment type (Qt.Alignment)
type	ORed subwidget flags

Reimplemented in QDS_LineEdit.

References QDS_Datum.initDatum(), QDS.Label, QDS_Datum.labelWidget(), QDS.Units, and QDS_Datum.unitsWidget().

QString QDS_Datum::unitsToText ( const QString & uni ) [static, inherited]

Parameters:

uni	units to be converted

Returns:: text presentation of units (rich-text)

QString QDS_Datum::textToUnits ( const QString & txt ) [static, inherited]

Parameters:

txt	text presentation of units (rich-text)

Returns:: units value

bool QDS_Datum::eventFilter	(	QObject *	o,
		QEvent *	e
	)		`[virtual, inherited]`

Perform delayed initialisation. Reimplemented for internal reasons.

Parameters:

o	event reciever object
e	event

Returns:: true if event should be filtered

References QDS_Datum.initDatum().

QDS_Datum::operator QWidget * ( ) const [inherited]

Returns:: QDS.Control subwidget

References QDS.Control, and QDS_Datum.widget().

bool QDS_Datum::isCustomTr ( ) const [inherited]

Returns:: true if custom translation is enabled

References QDS_Datum.myTr.

void QDS_Datum::enableCustomTr ( const bool on ) [inherited]

Custom translation means that text labels of datums are translated with help of standard Qt mechanism of internationalization. In this case special records should be placed into *.ts files under context "QDS". For example, if label has name "myLabel", the corresponding translation should be written: <context> <name>QDS</name> <message> <source>myLabel</source> <translation>myLabel translation</translation> </message> ...

If custom translation mechanism is deactivated, then labels will be shown with text got from xml data dictionary file

By default, the custom translation is deactivated

Parameters:

on	- if it is true, custom translation is activated, otherwise, deactivated

References QDS_Datum.label(), QDS_Datum.labelWidget(), and QDS_Datum.myTr.

void QDS_Datum::paramChanged ( ) [signal, inherited]

void QDS_Datum.paramChanged ( QString & ) [signal, inherited]

void QDS_Datum::onParamChanged ( ) [protected, virtual, slot, inherited]

Reimplemented in QDS_CheckBox, and QDS_LineEdit.

QLabel * QDS_Datum::labelWidget ( ) const [protected, inherited]

Returns:: label widget

References QDS_Datum.initDatum(), and QDS_Datum.myLabel.

QLabel * QDS_Datum::unitsWidget ( ) const [protected, inherited]

Returns:: units widget

References QDS_Datum.initDatum(), and QDS_Datum.myUnits.

QWidget * QDS_Datum::controlWidget ( ) const [protected, inherited]

Returns:: control widget

References QDS_Datum.initDatum(), and QDS_Datum.myControl.

QDS_Datum.Handle ( DDS_DicItem ) const [protected, inherited]

void QDS_Datum::setDicItem ( const Handle(DDS_DicItem)& item ) [protected, inherited]

Parameters:

item	handle to data dictionary item

int QDS_Datum::flags ( ) const [protected, inherited]

Returns:: datum flags (QDS.DatumFlags)

References QDS_Datum.myFlags.

void QDS_Datum::invalidateCache ( ) [protected, inherited]

References QDS_Datum.myTargetValue.

QLabel * QDS_Datum::createLabel ( QWidget * parent ) [protected, virtual, inherited]

Parameters:

parent parent widget

Returns:: label widget

QLabel * QDS_Datum::createUnits ( QWidget * parent ) [protected, virtual, inherited]

Parameters:

parent parent widget

Returns:: units widget

bool QDS_Datum::validate ( const QString & txt ) const [protected, virtual, inherited]

Parameters:

txt	string to be validated

Returns:: true if string contains valid data

References QDS_Datum.format(), QDS_Datum.isDoubleFormat(), DDS_DicItem.String, QDS_Datum.type(), DDS_DicItem.Unknown, and QDS_Datum.validator().

QString QDS_Datum::prefix ( ) const [protected, inherited]

Returns:: current implementation returns null string

QString QDS_Datum::suffix ( ) const [protected, inherited]

Returns:: current implementation returns null string

QString QDS_Datum::minValue ( ) const [protected, virtual, inherited]

Returns:: minimum value

References QDS_Datum.minimumValue(), QDS_Datum.prefix(), and QDS_Datum.suffix().

QString QDS_Datum::maxValue ( ) const [protected, virtual, inherited]

Returns:: maximum value

References QDS_Datum.maximumValue(), QDS_Datum.prefix(), and QDS_Datum.suffix().

QString QDS_Datum::sprintf	(	const QString &	fmt,
		const int	val
	)		`[static, protected, inherited]`

Process some non standard flags from format string.

Parameters:

fmt	string format
val	value

Returns:: formatted value

References QDS_Datum.canonicalFormat().

QString QDS_Datum::sprintf	(	const QString &	fmt,
		const double	val
	)		`[static, protected, inherited]`

Parameters:

fmt	string format
val	value

Returns:: formatted value

References QDS_Datum.canonicalFormat().

QString QDS_Datum::sprintf	(	const QString &	fmt,
		const QString &	val
	)		`[static, protected, inherited]`

Parameters:

fmt	string format
val	value

Returns:: formatted value

References QDS_Datum.canonicalFormat(), QDS_Datum.isDoubleFormat(), rx, and QDS_Datum.sprintf().

void QDS_Datum::initDatum ( ) const [protected, inherited]

References QDS_Datum.initialize(), and QDS_Datum.myInitialised.

bool QDS::load ( const QString & dictPath ) [static, inherited]

Returns:: true if loading is successed or false otherwise.

References QDS.toAsciiString().

QString QDS::unitSystemLabel	(	const QString &	sys,
		const QString &	comp = `QString()`
	)		`[static, inherited]`

If component comp is specified and not empty then the function searches the given unit system in the specified component, otherwise all components will be searched.

Parameters:

sys	unit system
comp	component

Returns:: unit system lavel or empty string if unit system is not found

References Handle(), TCollection_AsciiString, QDS.toAsciiString(), and QDS.toQString().

QString QDS::activeUnitSystem ( const QString & comp = QString() ) [static, inherited]

If component is not specified or empty string, then the first found component will be used.

If component exists, then active unit system name is returned. Otherwise, empty string is returned.

Parameters:

comp component

Returns:: name of the active unit system

References Handle(), QDS.toAsciiString(), and QDS.toQString().

void QDS::setActiveUnitSystem	(	const QString &	sys,
		const QString &	comp = `QString()`
	)		`[static, inherited]`

If not empty component name comp is specified, then the unit system will be activated in the given component, otherwise all components will be processed.

After the changing of active unit system function notifies about it all registered datums from processed components using method QDS_Datum.unitSystemChanged()

Parameters:

unit	system to be set active
comp	component

References QDS._datumList, QDS.activeUnitSystem(), Handle(), TCollection_AsciiString, QDS.toAsciiString(), and QDS_Datum.unitSystemChanged().

QString QDS::toQString ( const TCollection_AsciiString & src ) [static, inherited]

Parameters:

src	OCC ASCII string

Returns:: Qt string

QString QDS::toQString ( const TCollection_ExtendedString & src ) [static, inherited]

Parameters:

src	OCC Unicode string

Returns:: Qt string

References TCollection_AsciiString, and QDS.toQString().

QString QDS::toQString ( const Handle(TCollection_HAsciiString)& src ) [static, inherited]

Parameters:

src	handle to OCC ASCII string

Returns:: Qt string

References QDS.toQString().

QString QDS::toQString ( const Handle(TCollection_HExtendedString)& src ) [static, inherited]

Parameters:

src	handle to OCC Unicode string

Returns:: Qt string

References QDS.toQString().

TCollection_AsciiString QDS::toAsciiString ( const QString & src ) [static, inherited]

Parameters:

src Qt string

Returns:: OCC ASCII string

References TCollection_AsciiString.

TCollection_AsciiString QDS::toAsciiString ( const TCollection_ExtendedString & src ) [static, inherited]

Parameters:

src	OCC Unicode string

Returns:: OCC ASCII string

References TCollection_AsciiString.

TCollection_AsciiString QDS::toAsciiString ( const Handle(TCollection_HExtendedString)& src ) [static, inherited]

Parameters:

src	handle to OCC Unicode string

Returns:: OCC ASCII string

References TCollection_AsciiString, and QDS.toAsciiString().

TCollection_ExtendedString QDS::toExtString ( const QString & src ) [static, inherited]

Parameters:

src Qt string

Returns:: OCC Unicode string

TCollection_ExtendedString QDS::toExtString ( const TCollection_AsciiString & src ) [static, inherited]

Parameters:

src	OCC ASCII string

Returns:: OCC Unicode string

void QDS::insertDatum ( QDS_Datum * datum ) [static, protected, inherited]

This function is invoked automatically by QDS_Datum constructor.

Parameters:

datum datum being registered

References QDS._datumList.

void QDS::removeDatum ( QDS_Datum * datum ) [static, protected, inherited]

This function is invoked automatically by QDS_Datum destructor.

Parameters:

datum datum being unregistered

References QDS._datumList.

Field Documentation

IdValueMap QDS_ComboBox.myValue [private]

IdStateMap QDS_ComboBox.myState [private]

IdIndexMap QDS_ComboBox.myIndex [private]

IdIconsMap QDS_ComboBox.myIcons [private]

QIntList QDS_ComboBox.myDataIds [private]

QIntList QDS_ComboBox.myUserIds [private]

QStringList QDS_ComboBox.myUserNames [private]

QDS_ComboBox Class Reference

Public Types

Public Slots

Signals

Public Member Functions

Static Public Member Functions

Protected Slots

Protected Member Functions

Static Protected Member Functions

Private Types

Private Member Functions

Private Attributes

Member Typedef Documentation

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Field Documentation