GUI implementation of the QtxPreferenceMgr class: preferences manager.
#include <QtxPagePrefMgr.h>

Public Slots | |
| virtual void | setVisible (bool) |
| Customize show/hide widget operation. | |
Signals | |
| void | resourceChanged (int) |
| void | resourceChanged (QString &, QString &) |
| void | resourcesChanged (const QMap< int, QString > &) |
Public Member Functions | |
| QtxPagePrefMgr (QtxResourceMgr *, QWidget *=0) | |
| Constructor. | |
| virtual | ~QtxPagePrefMgr () |
| Destructor. | |
| virtual QSize | sizeHint () const |
| Get recommended size for the widget. | |
| virtual QSize | minimumSizeHint () const |
| Get recommended minimum size for the widget. | |
| virtual void | updateContents () |
| Update widget contents. | |
| virtual QtxResourceMgr * | resourceMgr () const |
| Get the resources manager. | |
| virtual QtxPreferenceMgr * | preferenceMgr () const |
| Get the parent preferences manager. | |
| QVariant | option (const int, const QString &) const |
| Get preference item option value. | |
| QVariant | option (const QString &) const |
| Get preference item option value. | |
| void | setOption (const int, const QString &, const QVariant &) |
| Set preference item option value. | |
| void | setOption (const QString &, const QVariant &) |
| Set preference item option value. | |
| virtual void | store () |
| Store all preferences item to the resource manager. | |
| virtual void | retrieve () |
| Retrieve all preference items from the resource manager. | |
| virtual void | update () |
| Update preferences manager. | |
| virtual void | toBackup () |
| Dumps all values to the backup container. | |
| virtual void | fromBackup () |
| Restore all values from the backup container. | |
| 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 | setTitle (const QString &) |
| Set preference item title . | |
| virtual void | setResource (const QString &, const QString &) |
| Assign resource file settings to the preference item. | |
| 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 void | activate () |
| void | ensureVisible () |
Static Public Member Functions | |
| static int | RTTI () |
| Specify unique item class identifier. | |
Protected Types | |
| typedef QMap < QtxPreferenceItem *, QString > | ResourceMap |
| typedef QList < QtxPreferenceItem * > | ItemList |
Protected Member Functions | |
| 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. | |
| virtual QVariant | optionValue (const QString &) const |
| Get preference item option value. | |
| virtual void | setOptionValue (const QString &, const QVariant &) |
| Set preference item option value. | |
| void | resourceValues (QMap< int, QString > &) const |
| Get all resources items values. | |
| void | resourceValues (ResourceMap &) const |
| Get all resources items values. | |
| void | setResourceValues (QMap< int, QString > &) const |
| Set all resources items values. | |
| void | setResourceValues (ResourceMap &) const |
| Set all resources items values. | |
| void | differentValues (const QMap< int, QString > &, const QMap< int, QString > &, QMap< int, QString > &, const bool fromFirst=false) const |
| Compare two maps of resources values to find differences. | |
| void | differentValues (const ResourceMap &, const ResourceMap &, ResourceMap &, const bool fromFirst=false) const |
| Compare two maps of resources values to find differences. | |
| virtual void | changedResources (const ResourceMap &) |
| Perform custom activity on resource changing. | |
| 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 Member Functions | |
| void | initialize () const |
| Perform internal initialization. | |
| void | initialize (QtxPreferenceItem *) |
Private Attributes | |
| QtxGridBox * | myBox |
| bool | myInit |
typedef QMap<QtxPreferenceItem*, QString> QtxPreferenceMgr.ResourceMap [protected, inherited] |
typedef QList<QtxPreferenceItem*> QtxPreferenceItem.ItemList [protected, inherited] |
| QtxPagePrefMgr::QtxPagePrefMgr | ( | QtxResourceMgr * | resMgr, |
| QWidget * | parent = 0 |
||
| ) |
| resMgr | resource manager |
| parent | parent widget |
References Horizontal, and myBox.
| QtxPagePrefMgr::~QtxPagePrefMgr | ( | ) | [virtual] |
| QSize QtxPagePrefMgr::sizeHint | ( | ) | const [virtual] |
| QSize QtxPagePrefMgr::minimumSizeHint | ( | ) | const [virtual] |
| void QtxPagePrefMgr::updateContents | ( | ) | [virtual] |
Reimplemented from QtxPreferenceItem.
References QtxPreferenceItem.childItems(), QtxPreferenceItem.icon(), myBox, and QtxPagePrefItem.widget().
| void QtxPagePrefMgr.resourceChanged | ( | int | ) | [signal] |
| void QtxPagePrefMgr.resourceChanged | ( | QString & | , |
| QString & | |||
| ) | [signal] |
| void QtxPagePrefMgr.resourcesChanged | ( | const QMap< int, QString > & | ) | [signal] |
| void QtxPagePrefMgr::setVisible | ( | bool | on | ) | [virtual, slot] |
| on | if true the widget is being shown, otherswise it is being hidden |
References initialize().
| void QtxPagePrefMgr::itemAdded | ( | QtxPreferenceItem * | ) | [protected, virtual] |
| item | child item being added |
Reimplemented from QtxPreferenceItem.
References QtxPreferenceItem.triggerUpdate().
| void QtxPagePrefMgr::itemRemoved | ( | QtxPreferenceItem * | ) | [protected, virtual] |
| item | child item being removed |
Reimplemented from QtxPreferenceItem.
References QtxPreferenceItem.triggerUpdate().
| void QtxPagePrefMgr::itemChanged | ( | QtxPreferenceItem * | ) | [protected, virtual] |
| item | child item being modified |
Reimplemented from QtxPreferenceItem.
References QtxPreferenceItem.triggerUpdate().
| QVariant QtxPagePrefMgr::optionValue | ( | const QString & | name | ) | const [protected, virtual] |
| name | option name |
Reimplemented from QtxPreferenceItem.
Reimplemented in SUIT_PreferenceMgr.
References Horizontal, myBox, QtxGridBox.orientation(), and Vertical.
| void QtxPagePrefMgr::setOptionValue | ( | const QString & | name, |
| const QVariant & | val | ||
| ) | [protected, virtual] |
| name | option name |
| val | new property value |
Reimplemented from QtxPreferenceItem.
Reimplemented in SUIT_PreferenceMgr.
References Horizontal, myBox, QtxGridBox.setOrientation(), and Vertical.
| void QtxPagePrefMgr::initialize | ( | ) | const [private] |
References initialize().
| void QtxPagePrefMgr::initialize | ( | QtxPreferenceItem * | item | ) | [private] |
References QtxPreferenceItem.childItems(), initialize(), and updateContents().
| QtxResourceMgr * QtxPreferenceMgr::resourceMgr | ( | ) | const [virtual, inherited] |
Reimplemented from QtxPreferenceItem.
References QtxPreferenceMgr.myResMgr.
| QtxPreferenceMgr * QtxPreferenceMgr::preferenceMgr | ( | ) | const [virtual, inherited] |
Reimplemented from QtxPreferenceItem.
| QVariant QtxPreferenceMgr::option | ( | const int | id, |
| const QString & | propName | ||
| ) | const [inherited] |
| id | preference item ID |
| propName | option name |
References QtxPreferenceItem.findItem(), and QtxPreferenceItem.option().
| QVariant QtxPreferenceItem::option | ( | const QString & | name | ) | const [inherited] |
| name | option name |
References QtxPreferenceItem.optionValue().
| void QtxPreferenceMgr::setOption | ( | const int | id, |
| const QString & | propName, | ||
| const QVariant & | propValue | ||
| ) | [inherited] |
| id | preference item ID |
| propName | option name |
| propValue | new property value |
References QtxPreferenceItem.findItem(), and QtxPreferenceItem.setOption().
| void QtxPreferenceItem::setOption | ( | const QString & | name, |
| const QVariant & | val | ||
| ) | [inherited] |
| name | option name |
| val | new property value |
References QtxPreferenceItem.optionValue(), QtxPreferenceItem.sendItemChanges(), and QtxPreferenceItem.setOptionValue().
| void QtxPreferenceMgr::store | ( | ) | [virtual, inherited] |
Implements QtxPreferenceItem.
References QtxPreferenceMgr.changedResources(), QtxPreferenceItem.childItems(), QtxPreferenceMgr.differentValues(), and QtxPreferenceMgr.resourceValues().
| void QtxPreferenceMgr::retrieve | ( | ) | [virtual, inherited] |
| void QtxPreferenceMgr::update | ( | ) | [virtual, inherited] |
Base implementation does nothing.
| void QtxPreferenceMgr::toBackup | ( | ) | [virtual, inherited] |
References QtxPreferenceMgr.myBackup, and QtxPreferenceMgr.resourceValues().
| void QtxPreferenceMgr::fromBackup | ( | ) | [virtual, inherited] |
| void QtxPreferenceMgr::resourceValues | ( | QMap< int, QString > & | map | ) | const [protected, inherited] |
| map | used as container filled with the resources values (<ID>: |
)
References QtxPreferenceItem.childItems(), QtxResourceMgr.hasValue(), QtxPreferenceItem.id(), QtxPreferenceItem.resource(), QtxPreferenceMgr.resourceMgr(), and QtxPreferenceItem.resourceValue().
| void QtxPreferenceMgr::resourceValues | ( | ResourceMap & | map | ) | const [protected, inherited] |
| map | used as container filled with the resources values (: |
)
References QtxPreferenceItem.childItems(), QtxResourceMgr.hasValue(), QtxPreferenceItem.resource(), QtxPreferenceMgr.resourceMgr(), and QtxPreferenceItem.resourceValue().
| void QtxPreferenceMgr::setResourceValues | ( | QMap< int, QString > & | map | ) | const [protected, inherited] |
| map | map with resources values (<ID>: |
)
References QtxPreferenceItem.findItem(), and QtxPreferenceItem.setResourceValue().
| void QtxPreferenceMgr::setResourceValues | ( | ResourceMap & | map | ) | const [protected, inherited] |
| void QtxPreferenceMgr::differentValues | ( | const QMap< int, QString > & | map1, |
| const QMap< int, QString > & | map2, | ||
| QMap< int, QString > & | resMap, | ||
| const bool | fromFirst = false |
||
| ) | const [protected, inherited] |
| map1 | first map |
| map2 | second map |
| resMap | map to be filled with different values |
| fromFirst | if true, then resMap will be filled with the values from map1, otherwise - from map2 |
| void QtxPreferenceMgr::differentValues | ( | const ResourceMap & | map1, |
| const ResourceMap & | map2, | ||
| ResourceMap & | resMap, | ||
| const bool | fromFirst = false |
||
| ) | const [protected, inherited] |
| map1 | first map |
| map2 | second map |
| resMap | map to be filled with different values |
| fromFirst | if true, then resMap will be filled with the values from map1, otherwise - from map2 |
| void QtxPreferenceMgr::changedResources | ( | const ResourceMap & | ) | [protected, virtual, inherited] |
This method is called from store() and fromBackup() methods. Base implementation does nothing.
Reimplemented in LightApp_Preferences.
| int QtxPreferenceItem::id | ( | ) | const [inherited] |
References QtxPreferenceItem.myId.
| int QtxPreferenceItem::rtti | ( | ) | const [virtual, inherited] |
References QtxPreferenceItem.RTTI().
| QtxPreferenceItem * QtxPreferenceItem::rootItem | ( | ) | const [inherited] |
References QtxPreferenceItem.parentItem().
| QtxPreferenceItem * QtxPreferenceItem::parentItem | ( | ) | const [inherited] |
References QtxPreferenceItem.myParent.
| QList< QtxPreferenceItem * > QtxPreferenceItem::childItems | ( | const bool | rec = false | ) | const [inherited] |
| rec | recursion boolean flag |
References QtxPreferenceItem.myChildren.
| int QtxPreferenceItem::depth | ( | ) | const [inherited] |
References QtxPreferenceItem.depth(), and QtxPreferenceItem.parentItem().
| int QtxPreferenceItem::count | ( | ) | const [inherited] |
| bool QtxPreferenceItem::isEmpty | ( | ) | const [virtual, inherited] |
true if item does not have children References QtxPreferenceItem.myChildren.
| void QtxPreferenceItem::appendItem | ( | QtxPreferenceItem * | item | ) | [inherited] |
Removes (if necessary) the item from the previous parent.
| item | item to be added |
References QtxPreferenceItem.insertItem().
| void QtxPreferenceItem::removeItem | ( | QtxPreferenceItem * | item | ) | [inherited] |
| item | item to be removed |
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.
| item | item to be added |
| before | item before which is inserted new |
References QtxPreferenceItem.itemAdded(), QtxPreferenceItem.myChildren, QtxPreferenceItem.myParent, QtxPreferenceItem.parentItem(), and QtxPreferenceItem.removeItem().
| QIcon QtxPreferenceItem::icon | ( | ) | const [inherited] |
| QString QtxPreferenceItem::title | ( | ) | const [inherited] |
| void QtxPreferenceItem::resource | ( | QString & | sec, |
| QString & | param | ||
| ) | const [inherited] |
| sec | used to return resource file section name |
| param | used to return resource file parameter name |
References QtxPreferenceItem.myParameter, and QtxPreferenceItem.mySection.
| void QtxPreferenceItem::setIcon | ( | const QIcon & | ico | ) | [virtual, inherited] |
| ico | new item icon |
References QtxPreferenceItem.myIcon, and QtxPreferenceItem.sendItemChanges().
| void QtxPreferenceItem::setTitle | ( | const QString & | title | ) | [virtual, inherited] |
| title | new item title |
Reimplemented in QtxPageNamedPrefItem, QtxPagePrefLabelItem, and QtxPagePrefCheckItem.
References QtxPreferenceItem.myTitle, QtxPreferenceItem.sendItemChanges(), and QtxPreferenceItem.title().
| void QtxPreferenceItem::setResource | ( | const QString & | sec, |
| const QString & | param | ||
| ) | [virtual, inherited] |
| sec | resource file section name |
| param | resource file parameter name |
Reimplemented in QtxPagePrefGroupItem.
References QtxPreferenceItem.myParameter, and QtxPreferenceItem.mySection.
| bool QtxPreferenceItem::isEvaluateValues | ( | ) | const [inherited] |
References QtxPreferenceItem.myEval.
| void QtxPreferenceItem::setEvaluateValues | ( | const bool | on | ) | [inherited] |
References QtxPreferenceItem.myEval.
| QString QtxPreferenceItem::resourceValue | ( | ) | const [inherited] |
References QtxPreferenceItem.getString().
| void QtxPreferenceItem::setResourceValue | ( | const QString & | val | ) | [inherited] |
| val | new associated resource file setting value |
References QtxPreferenceItem.setString().
| QtxPreferenceItem * QtxPreferenceItem::findItem | ( | const int | id, |
| const bool | rec = false |
||
| ) | const [inherited] |
| id | child item ID |
| rec | if true recursive search is done |
References QtxPreferenceItem.findItem(), QtxPreferenceItem.id(), and QtxPreferenceItem.myChildren.
| QtxPreferenceItem * QtxPreferenceItem::findItem | ( | const QString & | title, |
| const bool | rec = false |
||
| ) | const [inherited] |
| title | child item title |
| rec | if true recursive search is done |
References QtxPreferenceItem.findItem(), QtxPreferenceItem.myChildren, and QtxPreferenceItem.title().
| QtxPreferenceItem * QtxPreferenceItem::findItem | ( | const QString & | title, |
| const int | id, | ||
| const bool | rec = false |
||
| ) | const [inherited] |
| title | child item title |
| id | child item ID |
| rec | if true recursive search is done |
References QtxPreferenceItem.findItem(), QtxPreferenceItem.id(), QtxPreferenceItem.myChildren, and QtxPreferenceItem.title().
| void QtxPreferenceItem::activate | ( | ) | [virtual, inherited] |
Reimplemented in QtxPagePrefItem.
| void QtxPreferenceItem::ensureVisible | ( | ) | [inherited] |
References QtxPreferenceItem.ensureVisible(), and QtxPreferenceItem.parentItem().
| void QtxPreferenceItem::ensureVisible | ( | QtxPreferenceItem * | ) | [protected, virtual, inherited] |
Reimplemented in QtxPagePrefItem, QtxPagePrefListItem, QtxPagePrefToolBoxItem, and QtxPagePrefTabsItem.
References QtxPreferenceItem.ensureVisible().
| int QtxPreferenceItem::RTTI | ( | ) | [static, inherited] |
| int QtxPreferenceItem::getInteger | ( | const int | val = 0 | ) | const [protected, inherited] |
| val | default value (returned if there is no such resource) |
References QtxResourceMgr.integerValue(), QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, and QtxPreferenceItem.resourceMgr().
| double QtxPreferenceItem::getDouble | ( | const double | val = 0.0 | ) | const [protected, inherited] |
| val | default value (returned if there is no such resource) |
References QtxResourceMgr.doubleValue(), QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, and QtxPreferenceItem.resourceMgr().
| bool QtxPreferenceItem::getBoolean | ( | const bool | val = false | ) | const [protected, inherited] |
| val | default value (returned if there is no such resource) |
References QtxResourceMgr.booleanValue(), QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, and QtxPreferenceItem.resourceMgr().
| QColor QtxPreferenceItem::getColor | ( | const QColor & | val = QColor() | ) | const [protected, inherited] |
| val | default value (returned if there is no such resource) |
References QtxResourceMgr.colorValue(), QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, and QtxPreferenceItem.resourceMgr().
| QFont QtxPreferenceItem::getFont | ( | const QFont & | val = QFont() | ) | const [protected, inherited] |
| val | default value (returned if there is no such resource) |
References QtxResourceMgr.fontValue(), QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, and QtxPreferenceItem.resourceMgr().
| QString QtxPreferenceItem::getString | ( | const QString & | val = QString() | ) | const [protected, inherited] |
| val | default value (returned if there is no such resource) |
References QtxPreferenceItem.isEvaluateValues(), QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, QtxPreferenceItem.resourceMgr(), and QtxResourceMgr.value().
| void QtxPreferenceItem::setInteger | ( | const int | val | ) | [protected, inherited] |
| val | new value |
References QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, QtxPreferenceItem.resourceMgr(), and QtxResourceMgr.setValue().
| void QtxPreferenceItem::setDouble | ( | const double | val | ) | [protected, inherited] |
| val | new value |
References QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, QtxPreferenceItem.resourceMgr(), and QtxResourceMgr.setValue().
| void QtxPreferenceItem::setBoolean | ( | const bool | val | ) | [protected, inherited] |
| val | new value |
References QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, QtxPreferenceItem.resourceMgr(), and QtxResourceMgr.setValue().
| void QtxPreferenceItem::setColor | ( | const QColor & | val | ) | [protected, inherited] |
| val | new value |
References QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, QtxPreferenceItem.resourceMgr(), and QtxResourceMgr.setValue().
| void QtxPreferenceItem::setFont | ( | const QFont & | val | ) | [protected, inherited] |
| val | new value |
References QtxPreferenceItem.myParameter, QtxPreferenceItem.mySection, QtxPreferenceItem.resourceMgr(), and QtxResourceMgr.setValue().
| void QtxPreferenceItem::setString | ( | const QString & | val | ) | [protected, inherited] |
| val | new value |
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] |
QtxGridBox* QtxPagePrefMgr.myBox [private] |
bool QtxPagePrefMgr.myInit [private] |