QCallList Class Reference
[QtTelephonyModule]

Detailed Description

The QCallList class provides an interface for recording the details of dialed, received, and missed calls.

See also QCallListItem.

Member Type Documentation

enum QCallList::DuplicateBehaviour

Defines the duplicate handling behavior of QCallList::record().

enum QCallList::ListType

Defines the type of the call list.

Member Function Documentation

QCallList::QCallList ( int maxItemCount = -1 )

Constructs a QCallList with an item limit of maxItemCount.

QCallList::~QCallList ()

Destructs the QCallList

QList<QCallListItem> QCallList::allCalls () const

Returns a QList containing this QCallList's calls.

QCallListItem QCallList::at ( uint posn ) const

Returns the QCallListItem at posn.

See also count().

void QCallList::clear ()

Clears the QCallList and saves the changes to the database. updated() signal is emitted.

uint QCallList::count () const

Returns the number of items in the QCallList.

See also at().

int QCallList::maxItems () const

Returns the item limit of the list.

See also setMaxItems().

void QCallList::record ( QCallListItem item, DuplicateBehaviour duplicates = AllowDuplicates )

Records the call item. If duplicates is AllowDuplicates (the default) duplicates of the number in item are allowed in the QCallList, otherwise any duplicate of the number is removed. The changes are saved to disk immediately.

Duplicates occur when the same number is dialed, received, or missed as a previously recorded call. The duplicate entry is stored with the new start and end times. If duplicates is OverwriteDuplicates, and the number was recently seen, then the original start and end times will be replaced with the new start and end times.

The OverwriteDuplicates flag is primarily used to collapse several recent entries for the same number into a single entry. This is mostly useful for repeated dial attempts, or repeated missed calls, where it is only interesting when the last attempt was made, not a full log of all attempts.

void QCallList::removeAll ( const QString & number )

Removes all items with the same number from the list. The changes a saved to the database immediately and updated() signal is emitted.

See also removeAt().

void QCallList::removeAll ( QCallListItem::CallType type )

This is an overloaded member function, provided for convenience.

Removes all items with the same type from the list. The changes are recorded to the database immediately and updated() signal is emitted.

See also removeAt().

void QCallList::removeAt ( uint posn )

Removes the item at posn from the list and saves the changes to the database. updated() signal is emitted.

See also removeAll().

QList<QCallListItem> QCallList::searchCalls ( SearchOptions & options ) const

Returns a QList containing QCallListItems that satisfy the search criteria options.

void QCallList::setMaxItems ( const int & l )

Sets the item limit of the list to l.

See also maxItems().

void QCallList::updated ()   [signal]

This signal is emitted whenever call list is updated.

See also clear(), record(), removeAll(), and removeAt().