Home · All Classes · Annotated · Functions

Contacts
Functional Description

The Contacts application allows the user to create contacts for storing information such as name, phone numbers, addresses and other personal information.

Data

A contact consists of the following data:

• First name
• Middle name
• Last name
• Pronunciation
• Nickname
• Suffix
• Job title
• Company
• Department
• Business phone
• Business fax
• Business street
• Business city
• Business zip code
• Business country
• Business pager
• Business web page
• Office
• Profession
• Assistant
• Manager
• Home phone
• Home street
• Home city
• Home state
• Home zip
• Home country
• Home web page
• Spouse
• Birthday
• Gender
• Anniversary
• Children
• Categories
• Photo
• Ring-tone
• Notes

Application views

It is possible to view contacts in the following three ways:

• As a sorted list of contacts.
• A detailed view of a single contact.
• A contact opened for editing.

Sorted list

The primary display of the application shows a sorted list of contacts.

From the sorted list view the user is able to:

• Create a new contact.
• View the details for the contact.
• Filter the list of contacts shown by a specified category.
• Filter the list of contacts by where they are stored (phone memory or SIM card).
• Beam all contacts.
• Change settings for how contact names are displayed.

Detailed view

The detailed view of a contact shows data for a single contact. This is shown as rich text. All the information for the task is shown formatted for optimum readability.

From the detailed list view the user is able to:

• Edit the current contact.
• Delete the current contact.
• Send the current contact via IR, SMS or email.
• Set the current contact as the owner's business card.

Edit view

The edit view of a contact allows the user to specify the data for a new contact or modify that of an existing contact. Once the user has finished they may either accept or discard the changes.

Features

Add contact

It is possible to add a contact. The user is able to specify as little as the name of the contact in order to create a new record.

Delete contact

It is possible to delete a contact. The user is prompted to verify the deletion of any contact.

Edit contact

It is possible to modify a contact an unlimited number of times.

Call contact

It is possible to call a contact with an associated phone number by selecting the contact's phone number when viewing their details.

SMS contact

It is possible to SMS a contact with an associated mobile phone number by selecting the contact's SMS mobile phone number.

Email contact

It is possible to email a contact with a valid email address by launching the Messages application with the contact's name and email address in the To field.

Beaming

It is possible to beam all or a single contact to or from another device using IR.

Transferring via SMS

It is possible to SMS all or a single contact to or from another device using the SMS protocol.

Transferring via email

It is possible to email all or a single contact to or from another device as an email attachment.

Associating an image with a contact

An image stored on the device's filesystem or taken directly from the device's camera may be associated with a contact. This image will displayed as part of the contact information where the contact is listed in the Contacts application, Call History, Dialer and Messages application.

QDL support

It is possible to access contacts via other applications via the QDL service interface. When activated the Contacts application runs and shows the contact.

QDL links can be embedded into the notes of a contact. When in the detailed view, clicking on a QDL link activates the link's application.

Files

Contacts uses data files:

• $HOME/Applications/addressbook/addressbook.xml - main list of contacts data.
• $HOME/.abjournal - journal of changes to list of contacts since application started.

Both files are in an xml-like format. addressbook.xml is the main list of contacts, and is the file sent to Qtopia Desktop on syncing. .abjournal is a list of adds, edits and deletes made to the list of contacts since the Contacts application started.

Config

Contacts stores settings in $HOME/Settings/Contacts.conf.

• [formatting]
• NameFormat - Format of contact names for filing.

Services

• IR Receive text/x-vCard
• Contacts - allows editing of contacts via PIM Library interface and beaming of a business card.
• PhoneContacts - allows a business card to be sent via SMS.
• QDL