GUI implementation of the resources font item.

#include <QtxPagePrefMgr.h>

Inheritance diagram for QtxPagePrefFontItem:

Public Member Functions
	QtxPagePrefFontItem (const int, const QString &, QtxPreferenceItem *=0, const QString &=QString(), const QString &=QString())
	Constructor.
	QtxPagePrefFontItem (const QString &, QtxPreferenceItem *=0, const QString &=QString(), const QString &=QString())
	Constructor.
virtual	~QtxPagePrefFontItem ()
	Destructor.
int	features () const
	Get font widget features.
void	setFeatures (const int)
	Set font widget features.
void	setMode (const int)
	Specifies whether widget works in Native or Custom mode. Native mode is intended for working with system fonts. Custom mode is intended for working with manually defined set of fonts. Set of custom fonts can be specified with setFonts() method.
int	mode () const
	Verifies whether widget works in Native or Custom mode.
void	setFonts (const QStringList &)
	Sets list of custom fonts. This method is intended for working in Custom mode only.
QStringList	fonts () const
	Gets list of custom fonts.
void	setSizes (const QList< int > &=QList< int >())
	Sets list of available font sizes. This method is intended for working in Custom mode only. The list of sizes can be empty. In this case system generate listof size automatically from 8 till 72.
QList< int >	sizes () const
	Gets list of custom fonts.
virtual void	store ()
	Store preference item to the resource manager.
virtual void	retrieve ()
	Retrieve preference item from the resource manager.
virtual void	setTitle (const QString &)
	Set preference title.
QWidget *	widget () const
	Get preference item editor widget.
virtual void	activate ()
void	ensureVisible ()
int	id () const
	Get unique item identifier.
virtual int	rtti () const
	Get unique item type identifier.
QtxPreferenceItem *	rootItem () const
	Get root preference item.
QtxPreferenceItem *	parentItem () const
	Get parent preference item.
QList< QtxPreferenceItem * >	childItems (const bool=false) const
	Get all child preference items.
int	depth () const
	Get preference item depth.
int	count () const
	Get child preference items number.
virtual bool	isEmpty () const
	Check if the item has children.
void	appendItem (QtxPreferenceItem *)
	Append child preference item.
void	removeItem (QtxPreferenceItem *)
	Remove child preference item.
void	insertItem (QtxPreferenceItem , QtxPreferenceItem =0)
	Insert child preference item before specified item. If the before item is 0 then new item is appended.
QIcon	icon () const
	Get preference item icon.
QString	title () const
	Get preference item title.
void	resource (QString &, QString &) const
	Get resource file settings associated to the preference item.
virtual void	setIcon (const QIcon &)
	Set prefence item icon.
virtual void	setResource (const QString &, const QString &)
	Assign resource file settings to the preference item.
virtual void	updateContents ()
	Update preference item.
QVariant	option (const QString &) const
	Get preference item option value.
void	setOption (const QString &, const QVariant &)
	Set preference item option value.
bool	isEvaluateValues () const
void	setEvaluateValues (const bool)
QString	resourceValue () const
	Get the value of the associated resource file setting.
void	setResourceValue (const QString &)
	Get the value of the associated resource file setting.
QtxPreferenceItem *	findItem (const int, const bool=false) const
	Find the item by the specified identifier.
QtxPreferenceItem *	findItem (const QString &, const bool=false) const
	Find the item by the specified title.
QtxPreferenceItem *	findItem (const QString &, const int, const bool=false) const
	Find the item by the specified title and identifier.
virtual QtxResourceMgr *	resourceMgr () const
	Get the resources manager.
virtual QtxPreferenceMgr *	preferenceMgr () const
	Get the parent preferences manager.
Static Public Member Functions
static void	adjustLabels (QtxPagePrefItem *)
static int	RTTI ()
	Specify unique item class identifier.
Protected Types
typedef QList < QtxPreferenceItem * >	ItemList
Protected Member Functions
virtual QVariant	optionValue (const QString &) const
	Get preference item option value.
virtual void	setOptionValue (const QString &, const QVariant &)
	Set preference item option value.
QLabel *	label () const
	Get label widget corresponding to the preference item.
QWidget *	control () const
	Get control widget corresponding to the preference item.
void	setControl (QWidget *)
	Set control widget corresponding to the preference item.
void	setWidget (QWidget *)
	Set preference item editor widget.
virtual void	itemAdded (QtxPreferenceItem *)
	Callback function which is called when the child preference item is added.
virtual void	itemRemoved (QtxPreferenceItem *)
	Callback function which is called when the child preference item is removed.
virtual void	itemChanged (QtxPreferenceItem *)
	Callback function which is called when the child preference item is modified.
void	pageChildItems (QList< QtxPagePrefItem * > &, const bool=false) const
	Find all child items of the QtxPagePrefItem type.
virtual void	widgetShown ()
	Invoked when preference item widget is shown.
virtual void	widgetHided ()
	Invoked when preference item widget is hided.
virtual void	ensureVisible (QtxPreferenceItem *)
int	getInteger (const int=0) const
	Get integer resources value corresponding to the item.
double	getDouble (const double=0.0) const
	Get double resources value corresponding to the item.
bool	getBoolean (const bool=false) const
	Get boolean resources value corresponding to the item.
QColor	getColor (const QColor &=QColor()) const
	Get color resources value corresponding to the item.
QFont	getFont (const QFont &=QFont()) const
	Get font resources value corresponding to the item.
QString	getString (const QString &=QString()) const
	Get string resources value corresponding to the item.
void	setInteger (const int)
	Set integer resources value corresponding to the item.
void	setDouble (const double)
	Set double resources value corresponding to the item.
void	setBoolean (const bool)
	Set boolean resources value corresponding to the item.
void	setColor (const QColor &)
	Set color resources value corresponding to the item.
void	setFont (const QFont &)
	Set font resources value corresponding to the item.
void	setString (const QString &)
	Set string resources value corresponding to the item.
void	sendItemChanges ()
	Initiate item changing call back operation.
virtual void	triggerUpdate ()
	Initiate item updating.
Private Attributes
QtxFontEdit *	myFont

Member Typedef Documentation

typedef QList<QtxPreferenceItem*> QtxPreferenceItem.ItemList [protected, inherited]

Constructor & Destructor Documentation

QtxPagePrefFontItem::QtxPagePrefFontItem	(	const int	feat,
		const QString &	title,
		QtxPreferenceItem *	parent = `0`,
		const QString &	sect = `QString()`,
		const QString &	param = `QString()`
	)

Parameters:

feat	font editor widget features (QtxFontEdit.Features)
title	preference item title
parent	parent preference item
sect	resource file section associated with the preference item
param	resource file parameter associated with the preference item

References myFont, and QtxPageNamedPrefItem.setControl().

QtxPagePrefFontItem::QtxPagePrefFontItem	(	const QString &	title,
		QtxPreferenceItem *	parent = `0`,
		const QString &	sect = `QString()`,
		const QString &	param = `QString()`
	)

Parameters:

title	preference item title
parent	parent preference item
sect	resource file section associated with the preference item
param	resource file parameter associated with the preference item

References myFont, and QtxPageNamedPrefItem.setControl().

QtxPagePrefFontItem::~QtxPagePrefFontItem ( ) [virtual]

Member Function Documentation

int QtxPagePrefFontItem::features ( ) const

Returns:: font widget features (ORed QtxFontEdit.Features flags)

See also:: setFeatures()

References QtxFontEdit.features(), and myFont.

void QtxPagePrefFontItem::setFeatures ( const int f )

Parameters:

f	new font widget features (ORed QtxFontEdit.Features flags)

See also:: features()

References myFont, and QtxFontEdit.setFeatures().

void QtxPagePrefFontItem::setMode ( const int mode )

Parameters:

mode	mode from QtxFontEdit.Mode enumeration

See also:: mode()

References myFont, and QtxFontEdit.setMode().

int QtxPagePrefFontItem::mode ( ) const

Returns:: Native or Custom mode

See also:: setMode()

References QtxFontEdit.mode(), and myFont.

void QtxPagePrefFontItem::setFonts ( const QStringList & fams )

Parameters:

fams	list of families

See also:: fonts(), setMode()

References myFont, and QtxFontEdit.setFonts().

QStringList QtxPagePrefFontItem::fonts ( ) const

Returns:: list of families

See also:: setFonts(), setMode()

References QtxFontEdit.fonts(), and myFont.

void QtxPagePrefFontItem::setSizes ( const QList< int > & sizes = QList<int>() )

Parameters:

sizes list of sizes

See also:: sizes(), setMode()

References myFont, and QtxFontEdit.setSizes().

QList< int > QtxPagePrefFontItem::sizes ( ) const

Returns:: list of families

See also:: setFonts(), setMode()

References myFont, and QtxFontEdit.sizes().

void QtxPagePrefFontItem::store ( ) [virtual]

See also:: retrieve()

Reimplemented from QtxPagePrefItem.

References QtxFontEdit.currentFont(), myFont, and QtxPreferenceItem.setFont().

void QtxPagePrefFontItem::retrieve ( ) [virtual]

See also:: store()

Reimplemented from QtxPagePrefItem.

References QtxPreferenceItem.getFont(), myFont, and QtxFontEdit.setCurrentFont().

QVariant QtxPagePrefFontItem::optionValue ( const QString & name ) const [protected, virtual]

Parameters:

name	option name

Returns:: property value or null QVariant if option is not set

See also:: setOptionValue()

Reimplemented from QtxPreferenceItem.

References features(), fonts(), mode(), and sizes().

void QtxPagePrefFontItem::setOptionValue	(	const QString &	name,
		const QVariant &	val
	)		`[protected, virtual]`

Parameters:

name	option name
val	new property value

See also:: optionValue()

Reimplemented from QtxPreferenceItem.

References setFeatures(), setFonts(), setMode(), and setSizes().

void QtxPageNamedPrefItem::setTitle ( const QString & txt ) [virtual, inherited]

Parameters:

txt	new preference title.

Reimplemented from QtxPreferenceItem.

References QtxPreferenceItem.isEmpty(), QtxPageNamedPrefItem.label(), and QtxPreferenceItem.title().

void QtxPageNamedPrefItem::adjustLabels ( QtxPagePrefItem * parent ) [static, inherited]

References QtxPreferenceItem.childItems(), and QtxPageNamedPrefItem.label().

QLabel * QtxPageNamedPrefItem::label ( ) const [protected, inherited]

Returns:: label widget

References QtxPageNamedPrefItem.myLabel.

QWidget * QtxPageNamedPrefItem::control ( ) const [protected, inherited]

Returns:: control widget

See also:: setControl()

References QtxPageNamedPrefItem.myControl.

void QtxPageNamedPrefItem::setControl ( QWidget * wid ) [protected, inherited]

Parameters:

wid	control widget

See also:: control()

References QtxPageNamedPrefItem.myControl, and QtxPagePrefItem.widget().

QWidget * QtxPagePrefItem::widget ( ) const [inherited]

Returns:: editor widget

See also:: setWidget()

References QtxPagePrefItem.myWidget.

void QtxPagePrefItem::activate ( ) [virtual, inherited]

Reimplemented from QtxPreferenceItem.

References QtxPagePrefItem.widget().

void QtxPagePrefItem::setWidget ( QWidget * wid ) [protected, inherited]

Parameters:

wid	editor widget

See also:: widget()

References QtxPagePrefItem.myListener, QtxPagePrefItem.myWidget, and QtxPreferenceItem.sendItemChanges().

void QtxPagePrefItem::itemAdded ( QtxPreferenceItem * ) [protected, virtual, inherited]

Parameters:

item	child item being added

See also:: itemRemoved(), itemChanged()

Reimplemented from QtxPreferenceItem.

References QtxPagePrefItem.contentChanged().

void QtxPagePrefItem::itemRemoved ( QtxPreferenceItem * ) [protected, virtual, inherited]

Parameters:

item	child item being removed

See also:: itemAdded(), itemChanged()

Reimplemented from QtxPreferenceItem.

References QtxPagePrefItem.contentChanged().

void QtxPagePrefItem::itemChanged ( QtxPreferenceItem * ) [protected, virtual, inherited]

Parameters:

item	child item being modified

See also:: itemAdded(), itemRemoved()

Reimplemented from QtxPreferenceItem.

References QtxPagePrefItem.contentChanged().

void QtxPagePrefItem::pageChildItems	(	QList< QtxPagePrefItem * > &	list,
		const bool	rec = `false`
	)		const `[protected, inherited]`

Parameters:

list	used to return list of child items
rec	if `true`, perform recursive search

References QtxPreferenceItem.childItems().

void QtxPagePrefItem::widgetShown ( ) [protected, virtual, inherited]

Reimplemented in QtxPagePrefListItem, QtxPagePrefFrameItem, and QtxPagePrefGroupItem.

void QtxPagePrefItem::widgetHided ( ) [protected, virtual, inherited]

void QtxPagePrefItem::ensureVisible ( QtxPreferenceItem * i ) [protected, virtual, inherited]

Reimplemented from QtxPreferenceItem.

Reimplemented in QtxPagePrefListItem, QtxPagePrefToolBoxItem, and QtxPagePrefTabsItem.

References QtxPreferenceItem.ensureVisible(), and QtxPagePrefItem.widget().

void QtxPreferenceItem::ensureVisible ( ) [inherited]

References QtxPreferenceItem.ensureVisible(), and QtxPreferenceItem.parentItem().

int QtxPreferenceItem::id ( ) const [inherited]

Returns:: item ID

References QtxPreferenceItem.myId.

int QtxPreferenceItem::rtti ( ) const [virtual, inherited]

Returns:: item type ID

References QtxPreferenceItem.RTTI().

QtxPreferenceItem * QtxPreferenceItem::rootItem ( ) const [inherited]

Returns:: root item

References QtxPreferenceItem.parentItem().

QtxPreferenceItem * QtxPreferenceItem::parentItem ( ) const [inherited]

Returns:: parent item

References QtxPreferenceItem.myParent.

QList< QtxPreferenceItem * > QtxPreferenceItem::childItems ( const bool rec = false ) const [inherited]

Parameters:

rec	recursion boolean flag

Returns:: list of child items

References QtxPreferenceItem.myChildren.

int QtxPreferenceItem::depth ( ) const [inherited]

Returns:: item depth

References QtxPreferenceItem.depth(), and QtxPreferenceItem.parentItem().

int QtxPreferenceItem::count ( ) const [inherited]

Returns:: number of child items

See also:: isEmpty()

References QtxPreferenceItem.myChildren.

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

Returns:: true if item does not have children

See also:: count()

References QtxPreferenceItem.myChildren.

void QtxPreferenceItem::appendItem ( QtxPreferenceItem * item ) [inherited]

Removes (if necessary) the item from the previous parent.

Parameters:

item	item to be added

See also:: removeItem()

References QtxPreferenceItem.insertItem().

void QtxPreferenceItem::removeItem ( QtxPreferenceItem * item ) [inherited]

Parameters:

item	item to be removed

See also:: insertItem()

References QtxPreferenceItem.itemRemoved(), QtxPreferenceItem.myChildren, and QtxPreferenceItem.myParent.

void QtxPreferenceItem::insertItem	(	QtxPreferenceItem *	item,
		QtxPreferenceItem *	before = `0`
	)		`[inherited]`

Removes (if necessary) the item from the previous parent.

Parameters:

item	item to be added
before	item before which is inserted new

See also:: removeItem()

References QtxPreferenceItem.itemAdded(), QtxPreferenceItem.myChildren, QtxPreferenceItem.myParent, QtxPreferenceItem.parentItem(), and QtxPreferenceItem.removeItem().

QIcon QtxPreferenceItem::icon ( ) const [inherited]

Returns:: item icon

See also:: setIcon()

References QtxPreferenceItem.myIcon.

QString QtxPreferenceItem::title ( ) const [inherited]

Returns:: item title

See also:: setTitle()

References QtxPreferenceItem.myTitle.

void QtxPreferenceItem::resource	(	QString &	sec,
		QString &	param
	)		const `[inherited]`

Parameters:

sec	used to return resource file section name
param	used to return resource file parameter name

See also:: setResource()

References QtxPreferenceItem.myParameter, and QtxPreferenceItem.mySection.

void QtxPreferenceItem::setIcon ( const QIcon & ico ) [virtual, inherited]

Parameters:

ico	new item icon

See also:: icon()

References QtxPreferenceItem.myIcon, and QtxPreferenceItem.sendItemChanges().

void QtxPreferenceItem::setResource	(	const QString &	sec,
		const QString &	param
	)		`[virtual, inherited]`

Parameters:

sec	resource file section name
param	resource file parameter name

See also:: resource()

Reimplemented in QtxPagePrefGroupItem.

References QtxPreferenceItem.myParameter, and QtxPreferenceItem.mySection.

void QtxPreferenceItem::updateContents ( ) [virtual, inherited]

Reimplemented in QtxPagePrefMgr, QtxPagePrefListItem, QtxPagePrefToolBoxItem, QtxPagePrefTabsItem, QtxPagePrefFrameItem, and QtxPagePrefGroupItem.

References QtxPreferenceItem.Updater.instance(), and QtxPreferenceItem.Updater.removeItem().

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

Parameters:

name	option name

Returns:: property value or null QVariant if option is not set

See also:: setOption()

References QtxPreferenceItem.optionValue().

void QtxPreferenceItem::setOption	(	const QString &	name,
		const QVariant &	val
	)		`[inherited]`

Parameters:

name	option name
val	new property value

See also:: option()

References QtxPreferenceItem.optionValue(), QtxPreferenceItem.sendItemChanges(), and QtxPreferenceItem.setOptionValue().

bool QtxPreferenceItem::isEvaluateValues ( ) const [inherited]

References QtxPreferenceItem.myEval.

void QtxPreferenceItem::setEvaluateValues ( const bool on ) [inherited]

References QtxPreferenceItem.myEval.

QString QtxPreferenceItem::resourceValue ( ) const [inherited]

Returns:: associated resource file setting value

See also:: setResourceValue()

References QtxPreferenceItem.getString().

void QtxPreferenceItem::setResourceValue ( const QString & val ) [inherited]

Parameters:

val	new associated resource file setting value

See also:: resourceValue()

References QtxPreferenceItem.setString().

QtxPreferenceItem * QtxPreferenceItem::findItem	(	const int	id,
		const bool	rec = `false`
	)		const `[inherited]`

Parameters:

id	child item ID
rec	if `true` recursive search is done

Returns:: child item or 0 if it is not found

References QtxPreferenceItem.findItem(), QtxPreferenceItem.id(), and QtxPreferenceItem.myChildren.

QtxPreferenceItem * QtxPreferenceItem::findItem	(	const QString &	title,
		const bool	rec = `false`
	)		const `[inherited]`

Parameters:

title	child item title
rec	if `true` recursive search is done

Returns:: child item or 0 if it is not found

References QtxPreferenceItem.findItem(), QtxPreferenceItem.myChildren, and QtxPreferenceItem.title().

QtxPreferenceItem * QtxPreferenceItem::findItem	(	const QString &	title,
		const int	id,
		const bool	rec = `false`
	)		const `[inherited]`

Parameters:

title	child item title
id	child item ID
rec	if `true` recursive search is done

Returns:: child item or 0 if it is not found

References QtxPreferenceItem.findItem(), QtxPreferenceItem.id(), QtxPreferenceItem.myChildren, and QtxPreferenceItem.title().

QtxResourceMgr * QtxPreferenceItem::resourceMgr ( ) const [virtual, inherited]

Returns:: resource manager pointer or 0 if it is not defined

Reimplemented in QtxPreferenceMgr.

References QtxPreferenceItem.preferenceMgr(), and QtxPreferenceMgr.resourceMgr().

QtxPreferenceMgr * QtxPreferenceItem::preferenceMgr ( ) const [virtual, inherited]

Returns:: preferences manager or 0 if it is not defined

Reimplemented in QtxPreferenceMgr.

References QtxPreferenceItem.parentItem(), and QtxPreferenceItem.preferenceMgr().

int QtxPreferenceItem::RTTI ( ) [static, inherited]

Returns:: item class ID

int QtxPreferenceItem::getInteger ( const int val = 0 ) const [protected, inherited]

Parameters:

val	default value (returned if there is no such resource)

Returns:: integer value of the associated resource

See also:: setInteger()

References QtxResourceMgr.integerValue(), QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, and QtxPreferenceItem.resourceMgr().

double QtxPreferenceItem::getDouble ( const double val = 0.0 ) const [protected, inherited]

Parameters:

val	default value (returned if there is no such resource)

Returns:: double value of the associated resource

See also:: setDouble()

References QtxResourceMgr.doubleValue(), QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, and QtxPreferenceItem.resourceMgr().

bool QtxPreferenceItem::getBoolean ( const bool val = false ) const [protected, inherited]

Parameters:

val	default value (returned if there is no such resource)

Returns:: boolean value of the associated resource

See also:: setBoolean()

References QtxResourceMgr.booleanValue(), QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, and QtxPreferenceItem.resourceMgr().

QColor QtxPreferenceItem::getColor ( const QColor & val = QColor() ) const [protected, inherited]

Parameters:

val	default value (returned if there is no such resource)

Returns:: color value of the associated resource

See also:: setColor()

References QtxResourceMgr.colorValue(), QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, and QtxPreferenceItem.resourceMgr().

QFont QtxPreferenceItem::getFont ( const QFont & val = QFont() ) const [protected, inherited]

Parameters:

val	default value (returned if there is no such resource)

Returns:: font value of the associated resource

See also:: setFont()

References QtxResourceMgr.fontValue(), QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, and QtxPreferenceItem.resourceMgr().

QString QtxPreferenceItem::getString ( const QString & val = QString() ) const [protected, inherited]

Parameters:

val	default value (returned if there is no such resource)

Returns:: string value of the associated resource

See also:: setString()

References QtxPreferenceItem.isEvaluateValues(), QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, QtxPreferenceItem.resourceMgr(), and QtxResourceMgr.value().

void QtxPreferenceItem::setInteger ( const int val ) [protected, inherited]

Parameters:

val new value

See also:: getInteger()

References QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, QtxPreferenceItem.resourceMgr(), and QtxResourceMgr.setValue().

void QtxPreferenceItem::setDouble ( const double val ) [protected, inherited]

Parameters:

val new value

See also:: getDouble()

References QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, QtxPreferenceItem.resourceMgr(), and QtxResourceMgr.setValue().

void QtxPreferenceItem::setBoolean ( const bool val ) [protected, inherited]

Parameters:

val new value

See also:: getBoolean()

References QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, QtxPreferenceItem.resourceMgr(), and QtxResourceMgr.setValue().

void QtxPreferenceItem::setColor ( const QColor & val ) [protected, inherited]

Parameters:

val new value

See also:: getColor()

References QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, QtxPreferenceItem.resourceMgr(), and QtxResourceMgr.setValue().

void QtxPreferenceItem::setFont ( const QFont & val ) [protected, inherited]

Parameters:

val new value

See also:: getFont()

References QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, QtxPreferenceItem.resourceMgr(), and QtxResourceMgr.setValue().

void QtxPreferenceItem::setString ( const QString & val ) [protected, inherited]

Parameters:

val new value

See also:: getString()

References QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, QtxPreferenceItem.resourceMgr(), and QtxResourceMgr.setValue().

void QtxPreferenceItem::sendItemChanges ( ) [protected, inherited]

References QtxPreferenceItem.itemChanged(), and QtxPreferenceItem.parentItem().

void QtxPreferenceItem::triggerUpdate ( ) [protected, virtual, inherited]

References QtxPreferenceItem.Updater.instance(), and QtxPreferenceItem.Updater.updateItem().

Field Documentation

QtxFontEdit* QtxPagePrefFontItem.myFont [private]

QtxPagePrefFontItem Class Reference

Public Member Functions

Static Public Member Functions

Protected Types

Protected Member Functions

Private Attributes

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Field Documentation