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

QSimIconReader Class Reference
[QtTelephonyModule]

The QSimIconReader class provides access to icons on a SIM. More...

    #include <QSimIconReader>

Inherits QObject.

• List of all members, including inherited members

Public Functions

• QSimIconReader ( const QString & service = QString(), QObject * parent = 0 )
• ~QSimIconReader ()
• bool haveIcon ( int iconId ) const
• QImage icon ( int iconId ) const
• void requestIcon ( int iconId )

• 29 public functions inherited from QObject

Signals

• void iconAvailable ( int iconId )
• void iconNotFound ( int iconId )

• 1 signal inherited from QObject

Additional Inherited Members

• 1 property inherited from QObject
• 1 public slot inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QObject
• 7 protected functions inherited from QObject
• 2 protected variables inherited from QObject

Detailed Description

The QSimIconReader class provides access to icons on a SIM.

This class is a convenience class wrapped around QBinarySimFile, to simplify access to SIM icons. The class caches previous icon images so that multiple requests for the same icon will not entail multiple commands to the SIM.

This class supports the monochrome and color icon formats described in 3GPP TS 51.011.

See also QBinarySimFile and QSimToolkit.

Member Function Documentation

QSimIconReader::QSimIconReader ( const QString & service = QString(), QObject * parent = 0 )

Construct a new SIM icon reader and attach it to parent. The icon files will be read from service.

QSimIconReader::~QSimIconReader ()

Destroy this SIM icon reader.

bool QSimIconReader::haveIcon ( int iconId ) const

Returns true if we have already required icon iconId; false otherwise. If this function returns true, then the return value from icon() for iconId will be a valid image.

See also icon() and requestIcon().

QImage QSimIconReader::icon ( int iconId ) const

Returns the cached icon image associated with iconId. If the icon has not been requested yet, this will return a null QImage.

See also haveIcon() and requestIcon().

void QSimIconReader::iconAvailable ( int iconId )   [signal]

Signal that is emitted when the icon associated with iconId is available via the icon() function.

See also requestIcon().

void QSimIconReader::iconNotFound ( int iconId )   [signal]

Signal that is emitted when the icon associated with iconId could not be found, usually because iconId is invalid, or because the SIM does not support reading icon files.

See also requestIcon().

void QSimIconReader::requestIcon ( int iconId )

Requests that the icon associated with iconId be fetched from the SIM. The service will respond with either the iconAvailable() or iconNotFound() signals.

See also haveIcon(), icon(), iconAvailable(), and iconNotFound().