![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Section Contents
Applications that use this class will not work correctly on a version of EPOC earlier than ER5.
Not applicable.
cntdb.h
cntmodel.lib
The TContactIter class can be used to iterate through sorted contact items contained in a contact database. All of the following functions which return a TContactItemId return a value of KNullContactId if the requested contact item cannot be found.
TContactIter(CContactDatabase& aDatabase);
The C++ constructor is used to construct the TContactIter object with a contact database.
CContactDatabase& aDatabase |
The contact database on which to iterate. |
TContactItemId FirstL();
Go to the first contact item in the database.
The ID of the first contact item. |
TContactItemId NextL();
Go to the next contact item in the database. On a newly initialised TContactIter, this function goes to the first item.
The ID of the next contact item. Has a value of KNullContactId if there are no more items. |
TContactItemId PreviousL();
Go to the previous contact item in the database.
The ID of the previous contact item. Has a value of KNullContactId if there is no previous item. |
You must not call this function on a newly initialised database, otherwise the function raises a panic.
TContactItemId LastL();
Go to the last contact item in the database.
The ID of the last contact item. |
void GotoL(TContactItemId aContactId);
Go to the specified contact item.
TContactItemId aContactId |
A contact item ID. Must not have a value of KNullContactId, or the function raises a panic. |
If the specified ID does not exist, the function leaves with KErrNotFound.
void Reset();
Reset the iterator to its initialised state, so that a subsequent call to NextL() goes to the first item.
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |