QSimIconReader Class Reference
[QtTelephonyModule]

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