9 --> |
9 --> |
10 <!DOCTYPE concept |
10 <!DOCTYPE concept |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
12 <concept id="GUID-40E64445-CBA3-59E4-A777-937609B311C9" xml:lang="en"><title>Contacts |
12 <concept id="GUID-40E64445-CBA3-59E4-A777-937609B311C9" xml:lang="en"><title>Contacts |
13 Model Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
13 Model Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
14 <section><title>Purpose</title> <p>The purpose of this document is to give |
14 <section id="GUID-C4F81B43-D09B-45AE-A616-B77398345918"><title>Purpose</title> <p>The purpose of this document is to give |
15 guidelines on how to use the Contacts Model API most efficiently for a range |
15 guidelines on how to use the Contacts Model API most efficiently for a range |
16 of typical operations. The Contacts Model is an engine component that provides |
16 of typical operations. The Contacts Model is an engine component that provides |
17 access to contact information stored on a Symbian OS device. Just like a real-world |
17 access to contact information stored on a device. Just like a real-world address |
18 address book it stores and organises names, telephone numbers, addresses and |
18 book it stores and organises names, telephone numbers, addresses and other |
19 other details of individuals and companies. It can be used to add, delete |
19 details of individuals and companies. It can be used to add, delete and edit |
20 and edit data as well as providing information to clients, and sorting and |
20 data as well as providing information to clients, and sorting and searching |
21 searching contacts. </p> </section> |
21 contacts. </p> </section> |
22 <section><title>Architectural Relationships</title> <p>The Contacts Model |
22 <section id="GUID-FE10E5CD-4F10-400D-AFDC-A00DDC22F6C7"><title>Architectural Relationships</title> <p>The Contacts Model |
23 is primarily used by messaging, telephony, synchronisation and vCard viewer |
23 is primarily used by messaging, telephony, synchronisation and vCard viewer |
24 clients on a Symbian OS device. </p> <fig id="GUID-79192704-415D-530B-8FEB-F73A5C93D0C2"> |
24 clients on a device. </p> <fig id="GUID-79192704-415D-530B-8FEB-F73A5C93D0C2"> |
25 <title> CONTACTS MODEL CLIENTS </title> |
25 <title> CONTACTS MODEL CLIENTS </title> |
26 <image href="GUID-5B6634EA-EB78-504E-BC5D-ABA67EEA06DF_d0e591102_href.png" placement="inline"/> |
26 <image href="GUID-5B6634EA-EB78-504E-BC5D-ABA67EEA06DF_d0e612282_href.png" placement="inline"/> |
27 </fig> </section> |
27 </fig> </section> |
28 <section><title>Description</title> <p>The <xref href="GUID-6A6C7B3B-1E44-3731-956D-590A1122FF6E.dita"><apiname>CContactDatabase</apiname></xref> class |
28 <section id="GUID-DF37BEEF-CF1D-42B4-A5E2-B3C8F69B33BD"><title>Description</title> <p>The <xref href="GUID-6A6C7B3B-1E44-3731-956D-590A1122FF6E.dita"><apiname>CContactDatabase</apiname></xref> class |
29 allows clients access to the contact data stored on the device and has the |
29 allows clients access to the contact data stored on the device and has the |
30 following functionality: </p> <p><b>Contact database management </b> </p> <p>More than one Contact Database |
30 following functionality: </p> <p><b>Contact database management </b> </p> <p>More than one Contact Database |
31 can exist on a phone, but a default Contact Database is used if no other is |
31 can exist on a phone, but a default Contact Database is used if no other is |
32 specified. Clients can open, close, alter and delete the Contact Database. |
32 specified. Clients can open, close, alter and delete the Contact Database. |
33 Extra databases can be added as required. The Contact Database can be moved |
33 Extra databases can be added as required. The Contact Database can be moved |