Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

QThemedView Class Reference
[QtBaseModule]

The QThemedView widget displays themed views in Qtopia. More...

    #include <QThemedView>

Inherits QGraphicsView.

This class was introduced in Qtopia 4.4.

• List of all members, including inherited members

Public Functions

• QThemedView ( QWidget * parent = 0, Qt::WindowFlags flags = 0 )
• ~QThemedView ()
• QString fileName () const
• QThemeItem * findItem ( const QString & name ) const
• bool load ( const QString & fileName )
• void setThemePrefix ( const QString & prefix )
• QString themePrefix () const
• QList<QThemeWidgetItem *> widgets () const

• 74 public functions inherited from QGraphicsView
• 15 public functions inherited from QAbstractScrollArea
• 13 public functions inherited from QFrame
• 206 public functions inherited from QWidget
• 29 public functions inherited from QObject
• 14 public functions inherited from QPaintDevice

Signals

• void itemClicked ( QThemeItem * item )
• void itemPressed ( QThemeItem * item )
• void itemReleased ( QThemeItem * item )

• 1 signal inherited from QWidget
• 1 signal inherited from QObject

Additional Inherited Members

• 13 properties inherited from QGraphicsView
• 2 properties inherited from QAbstractScrollArea
• 6 properties inherited from QFrame
• 57 properties inherited from QWidget
• 1 property inherited from QObject
• 3 public slots inherited from QGraphicsView
• 19 public slots inherited from QWidget
• 1 public slot inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QWidget
• 4 static public members inherited from QObject
• 3 protected functions inherited from QGraphicsView
• 16 protected functions inherited from QAbstractScrollArea
• 38 protected functions inherited from QWidget
• 7 protected functions inherited from QObject
• 1 protected function inherited from QPaintDevice
• 1 protected slot inherited from QGraphicsView
• 1 protected slot inherited from QAbstractScrollArea
• 1 protected slot inherited from QWidget
• 2 protected variables inherited from QObject
• 1 protected type inherited from QPaintDevice

Detailed Description

The QThemedView widget displays themed views in Qtopia.

A Qt Extended theme is made of multiple themed views, each described by an XML document called the themed view XML.

See also QThemeItem.

Member Function Documentation

QThemedView::QThemedView ( QWidget * parent = 0, Qt::WindowFlags flags = 0 )

Constructs a QThemedView object passing the parent widget and window flags to the QGraphicsView constructor.

QThemedView::~QThemedView ()

Destroys the QThemedView.

QString QThemedView::fileName () const

Returns the fileName of the view (for example title.xml).

QThemeItem * QThemedView::findItem ( const QString & name ) const

Finds the item in the theme item tree that has the name name.

Returns a pointer to the item if found, otherwise returns 0.

Use qgraphicsitem_cast() to cast the item to the desired type.

Example:

    QThemeWidgetItem *dialerLineEdit = qgraphicsitem_cast<QThemeWidgetItem*>(findItem("dialernumber"));
    if (dialerLineEdit) {
        dialerLineEdit->setWidget(new QLineEdit);
    }

void QThemedView::itemClicked ( QThemeItem * item )   [signal]

Emitted whenever the interactive item item is cliked.

void QThemedView::itemPressed ( QThemeItem * item )   [signal]

Emitted whenever the interactive item item is pressed.

void QThemedView::itemReleased ( QThemeItem * item )   [signal]

Emitted whenever the interactive item item is released.

bool QThemedView::load ( const QString & fileName )

Loads the view fileName. Returns true if it succeeds, false otherwise.

void QThemedView::setThemePrefix ( const QString & prefix )

Sets the prefix of the theme to prefix. The theme prefix should be set before loading the view.

Example:

    themedView->setThemePrefix("mytheme");
    themedView->load("/etc/themes/mytheme/title.xml");

The theme prefix is used by the view to find the images. For example if the theme prefix is set to mytheme, the view will look for images in $QTOPIA_PATH/pics/themes/mytheme/.

See also themePrefix() and load().

QString QThemedView::themePrefix () const

Returns the name of the theme.

See also setThemePrefix().

QList<QThemeWidgetItem *> QThemedView::widgets () const

Returns a list of all widgets on the view.