![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Section Contents
CActive |
Abstract: active object: provides facilities to encapsulate an asynchronous service, and to handle its completion using RunL(). |
etelbgsm.h
gsmbas.lib
This class enables clients to search through a phone book to locate search strings. The phone book to search is specified in the static function NewL(). The resulting phone book entries can be accessed via the CGsmPhoneBookSearchResults class.
This class is not intended for user derivation.
static CGsmPhoneBookSearch* NewL(RGsmPhoneBook& aPhoneBook);
Creates a new CGsmPhoneBookSearch initialised with the name of the phone book to be searched, and returns a handle to it.
RGsmPhoneBook& aPhoneBook |
The phone book to be searched. |
CGsmPhoneBookSearch* |
A handle to the new asynchronous phone book search object. |
CGsmPhoneBookSearch will be deleted if NewL() leaves.
~CGsmPhoneBookSearch();
The destructor frees all resources owned by the object, prior to its destruction. It invokes Cancel() to cancel any outstanding request, and removes the object from the active scheduler.
void Start(const RGsmPhoneBook::TSearchString& aSearch,TRequestStatus& aStatus);
This function starts a search through a phone book for entries that start with the search string.
const RGsmPhoneBook::TSearchString& aSearch |
The search string to be located. This is matched against the first letters in each entry. |
TRequestStatus& aStatus |
A variable that indicates the completion status of the request. |
CGsmPhoneBookResults* SearchResults() const;
This function returns the results of the last phone book search performed using the Start() function.
CGsmPhoneBookResults* |
A pointer to the results of the last phone book search. |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |