mainpage.dox

symbian v9.1 下的地址本程序

*    Message Description
 *
 *    1:     CAddressBookAppUi::HandleCommandL(TInt aCommand) is called on the AppUi object whenever the user selects a menu option. The argument aCommand indicates the command the user selected. In case if the user chose "EAddressBookCmdAppAdd" to add contact in phone book.
 *
 *    2,3:   CAddressBookEngine::GetContact(TInt aPosition, CAddressBookContact*& aContact) and CAddressBookView::CurrentContact() get information from current contact.
 *
 *    4:     CPbkContactEngine::CreateEmptyContactL() creates an empty item for contact information.
 *
 *    5-10:  CAddressBookContact::PhoneL(), CAddressBookContact::MobilePhoneL(),  CAddressBookContact::SelectedPhoneL(const TDesC8& aType), CAddressBookAppUi::UpdateFieldL(CPbkContactItem* modifiableItem, TPbkFieldId fieldId, const TDesC8& newValue) add in this item information about the mobile and general phones.
 *
 *    11-13: CAddressBookContact::FirstName(), CAddressBookContact::ChildValue(const TDesC8& aFirstElement, const TDesC8& aSecondElement), CAddressBookAppUi::UpdateFieldL(CPbkContactItem* modifiableItem, TPbkFieldId fieldId, const TDesC8& newValue) also add information about the first name.
*          The same steps follow for adding information about last name/fax/email/organization/title and street.
 *
 *    14:    CPbkContactEngine::AddNewContactL() adds new item about contact information in phonebook's database.
 *
*  \subsection Sub37 3.7 BrowseCard
*
*  \image html AddressBookBrowseCard.jpg
 *  <b> <center> figure6: Browse Card</center></b>
*
*    Message Description
 *
 *    1:     CAddressBookView::HandleListBoxEventL(CEikListBox*, TListBoxEvent aEventType) is called whenever the user presses "enter" button (EeventEnterKeyPressed) to browse full information about the employee.
 *
 *    2,3:   CAddressBookView::OpenItemL() and CAddressBookEngine::GetContact(TInt aPosition, CAddressBookContact*& aContact)  get information about current contact.
 *
 *    4-6:   CAddressBookView::AppendRowL(TPtrC8 aValue, const TDesC8& aFieldName, CDesCArray& aArray), CAddressBookContact::LastName(), CAddressBookContact::SelectedPhoneL(const TDesC8& aType) convert information about last name that to draw it as the separate row.
 *
 *    7-9:   CAddressBookView::AppendRowL(TPtrC8 aValue, const TDesC8& aFieldName, CDesCArray& aArray), CAddressBookContact::PhoneL(), CAddressBookContact::ChildValue(const TDesC8& aFirstElement, const TDesC8& aSecondElement) convert information about phone that to draw it as the separate row.
The same steps follow for first name/middle name/extra address/street/locality/region/post code/country/mobile phone/fax/email/title/organization/unit.
 *
 *    10:    CAddressBookView::ChangeCbaL(TInt aResourceId, TDrawNow aDrawNow) sets aResourceId = R_AVKON_SOFTKEYS_OPTIONS_BACK and state = EdrawNow.
 *
 *    11:    CAddressBookView::Draw() draws full information about employee who was found as rows.
 *
 *
*	<HR>
*
 *  \section Build_sec 4. Building and Running
 *
 *    When the application starts up, the following screen appears:
 *
*  \image html image001.jpg
 *  <b> <center> </center></b>
*
*    Selecting the Options soft key displays the following 3 choices:
*
*  \image html image003.jpg
 *  <b> <center> </center></b>
*
*    - Select About to display the information about this application.
*
*  \image html image005.jpg
 *  <b> <center> </center></b>
*
*    - Select Connect to connect to the authentication service.
 *    - Select Exit at any time to exit the application.
 *
*  \subsection Sub41 4.1 Select Connect from the Options menu.
*
 *	\subsubsection Subsub411 4.1.1 Introduction
 *
 *    Address book is provided by the imaginary enterprise and is its internal address book, which employees of the enterprise can use to find address & phone number information related to other people.
 *
 *    A user can make queries by providing some values. The address cards matching those values are returned. E.g. a family name can be given and all address cards containing exactly that family name will be returned, unless there are e.g. more than ten cards matching that value in which case a status code indicating too many matches will be returned and the end user should give more parameters, e.g. give also the given name.
*
 *	\subsubsection Subsub412 4.1.2 Use scenario
 *
*    1. User chooses Connect from the Options menu.
*
*  \image html image007.jpg
 *  <b> <center> </center></b>
  *
2. At this point application asks for available address book services (the company address book service based on the ProviderID).
* This note appears only once during first time of connection with service.
*
*  \image html image008.jpg
 *  <b> <center> </center></b>
  *
*   3. So WebServices connects to the authentication service, gets a resource offering for the discovery service and gets available address book services, unless the information is already cached.
*
*  \image html image009.jpg
 *  <b> <center> </center></b>
  *
*4. Appears a list of access points from which is needed to choose right. (For emulator it is "Ethernet with Daemon", for hardware it corresponds with SIM card.)

* 5. Appears the new options menu, where Search need to find an information about somebody.
*
*  \image html image011.jpg
*  <b> <center> </center></b>
*
*    6. When user chooses this point of menu appears the next note:
*
*  \image html image013.jpg
*  <b> <center> </center></b>
*
*    7. A screen for entering query parameters is displayed. Note: although the different address book services contain a bit different data, both have same available query parameters.
*
*  \image html image015.jpg
*  <b> <center> </center></b>
*
*    8. User types the query parameters, e.g. first name of a colleague to get the rest of the information or the phone number of a missed call to check, who called.
*
*  \image html image017.jpg
*  <b> <center> </center></b>
*
 *    9. As a response one of the following alternatives is received:
 *
*       - One address card matching the query. This must be displayed to the user.
*
 *       - More than one address card matching the query.
*
*  \image html image019.jpg
*  <b> <center> </center></b>
*
*    User can browse all the returned address cards.
*
*  \image html image021.jpg
*  <b> <center> </center></b>
*  \image html image023.jpg
*  <b> <center> </center></b>
*  \image html image025.jpg
*  <b> <center> </center></b>
*  \image html image027.jpg
*  <b> <center> </center></b>
*  \image html image029.jpg
*  <b> <center> </center></b>
*
*      - A status code indicating that too many card matched the query and a new query with more parameters (e.g. given name in addition to the family name) must be supplied to get address cards. This must be indicated to the user and a query screen with previously supplied parameters provided so that the user can easily add more and make new query.
*
*      - OK status code, but no address card, as there was no matching card. User must be told that no matching address cards were found.
*
*      - Some error code, as there was something wrong in the request or some problems in the backend system. Some status must be displayed to the user and user can try again.
*
*      - Nothing is received, as there were problems in communication channels, etc. Some timeout must be implemented to return to normal operation (user might try another search, close application, throw the terminal to a wall, etc)
*
*    10. If one or more than one address card matching the query there is opportunity to add them to contacts.
*
* \image html image031.jpg
*
 *
 * <HR>
 *
 * \section Hierarchy_sec 4. Class Hierarchy
This inheritance list is sorted roughly, but not completely, alphabetically:<ul>
<li><a class="el" href="class_c_address_book_app.html">CAddressBookApp</a>
<li><a class="el" href="class_c_address_book_contact.html">CAddressBookContact</a>
<li><a class="el" href="class_c_address_book_document.html">CAddressBookDocument</a>
<li><a class="el" href="class_c_address_book_engine.html">CAddressBookEngine</a>
<li><a class="el" href="class_c_address_book_view.html">CAddressBookView</a>
<li><a class="el" href="class_m_address_book_engine_observer.html">MAddressBookEngineObserver</a>
<ul>
<li><a class="el" href="class_c_address_book_app_ui.html">CAddressBookAppUi</a>
</ul>
</ul>
 */