QCallListItem Class Reference
[QtTelephonyModule]

Detailed Description

The QCallListItem class specifies information about a single dialed, received or missed call in a QCallList set.

See also QCallList.

Member Type Documentation

enum QCallListItem::CallType

This enum defines the types of calls that may be recorded.

Member Function Documentation

QCallListItem::QCallListItem ()

Constructs a null QCallListItem.

QCallListItem::QCallListItem ( CallType type, const QString & number, const QDateTime & start, const QDateTime & end, const QUniqueId & contact = QUniqueId(), const QString & serviceType = QString(), const QString & timeZoneId = QString(), bool simRecord = false )

Constructs a QCallListItem given the type of call, the phone number and the start and end times of the call. The contact can be optionally specified by contact. serviceType specifies the type of service such as Voice or VoIP. timeZoneId describes the time zone id at the time when the call is made e.g. Australia/Brisbane. If simRecord is true, then the call list item originated from a storage area on a SIM.

QCallListItem::QCallListItem ( CallType type, const QString & number, bool simRecord = true )

Constructs a QCallListItem given the type of call and the phone number. Use this constructor when reading SIM phone books as they contain only call type and phone number. If simRecord is true, then the call list item originated from a storage area on a SIM.

QCallListItem::QCallListItem ( const QCallListItem & other )

Constructs copy of other.

QCallListItem::~QCallListItem ()

Destructs the QCallListItem.

QUniqueId QCallListItem::contact () const

Returns the unique id of the contact associated with this call, if any.

void QCallListItem::deserialize ( Stream & stream )

Reads the contents of a QCallListItem from stream.

QDateTime QCallListItem::end () const

Returns end time of the call, or a null QDateTime if no connection was made for the call in the case of a missed call, or a dialed call that did not connect.

See also start() and originalTimeZoneEnd().

bool QCallListItem::isNull () const

Returns true if this is an invalid call list item.

bool QCallListItem::isSIMRecord () const

Returns true if the call item is imported from SIM phone book.

QString QCallListItem::number () const

Returns the phone number associated with this call.

QDateTime QCallListItem::originalTimeZoneEnd () const

Returns the ending time of the call in the original timezone that the user was in when the call was made or received.

This can be useful to display that a call ended at 11:05 am local time, regardless of what the timezone is set to now. The end() function returns the end time in the current timezone.

See also originalTimeZoneStart() and end().

QDateTime QCallListItem::originalTimeZoneStart () const

Returns the starting time of the call in the original timezone that the user was in when the call was made or received.

This can be useful to display that a call started at 11:00 am local time, regardless of what the timezone is set to now. The start() function returns the start time in the current timezone.

See also originalTimeZoneEnd() and start().

void QCallListItem::serialize ( Stream & stream ) const

Writes the contents of a QCallListItem to a stream.

QString QCallListItem::serviceType () const

Returns the service type associated with this call (Voice, Data, etc).

QDateTime QCallListItem::start () const

Returns the starting time of the call.

See also end() and originalTimeZoneStart().

QString QCallListItem::timeZoneId () const

Returns the time zone id associated with this call (e.g. Australia/Brisbane).

CallType QCallListItem::type () const

Returns the type of call this item represents. If this item is null, then the return value of this function is undefined.

See also QCallListItem::CallType.

bool QCallListItem::operator!= ( const QCallListItem & other ) const

Returns true if this item is different than other or false if they are the same.

QCallListItem & QCallListItem::operator= ( const QCallListItem & other )

Assigns a copy of other to this item.

bool QCallListItem::operator== ( const QCallListItem & other ) const

Returns true if this item is the same as other or false if they are different.

The time properties such as start() and end() are converted to string using Qt::ISODate format for comparison.