Developers guide

Chapter 22: Wireless Wide-Area Networking
Data Coding Schemes For Phone Book Entries
Psion Teklogix Mobile Devices SDK Developers Guide 231
Writing Phone Book Entries
To create a new phone book entry:
•Use the AddPhonebookEntry method for the selected Phonebook object. A
PhonebookEntry object representing the new phone book entry is returned.
Volatile
A phone book is volatile if its content can change at any time. Modems change this type of phone
book, as well as the Mobile Devices SDK. Dialled Calls, Received Calls, and Missed Calls phone
books are volatile; however, Regular, Service Numbers, Own Numbers, and Voicemail Access
Number phone books are never volatile. If you want to make sure that you never miss a change in
a volatile phone book, then you must re-read them whenever a call is disconnected.
Writable/Modifiable
Depending on the types of entries stored in a phone book, it may be writable or it may be read-
only. See “Phone Book Types” on page 232
for more information.
22.13.1 Data Coding Schemes For Phone Book Entries
The data coding scheme for a phone book entry determines how many characters can be stored in
the entry. For example, you can store approximately twice as many characters using an 8-bit al-
phabet as you can with a 16-bit alphabet.
A phone book can contain entries that use different alphabets.
The following alphabets can be used to store phone book entries:
•SMS Default
• SMS GSM 7-bit
• SMS ASCII 8-bit
• SMS Unicode 16-bit
• SMS Binary 8-bit
• SMS GSM PDU
Unicode entries must be stored in a 16-bit alphabet.
SIM cards can only store entries in SMS GSM 7-bit and SMS Unicode 16-bit.
The SMS Default uses the driver default algorithm for selecting the alphabet for an entry. The
driver examines the characters used in the name, and the driver selects the alphabet that stores the
maximum number of characters in the space available for the entry.
{
number_combo.Items.Add(entry.GetName());
}
}
}
}
if (number_combo.Items.Count > 0)
{
number_combo.SelectedIndex = 0;
}
Example 22.21 Adding Contacts From A SIM Card To A Combo Box in C++