Symbian S60独有通讯录操作API引擎
以上是适用于任何 Symbian OS通讯录操作的方法，在S60平台SDK中nokia专门为我们建立了一个操作通讯录的引擎，以及相对应的产生了一些封装的类：
- CPbkContactEngine（通讯录引擎类）：如果已经存在一个缺省数据库，CPbkContactEngine:: NewL()就连接到该数据库，否则创建该数据库。当然也可以传入文件名，打开一个指定的通讯录数据库，根据头文件 cpbkcontactengine.h，他就是对CContactDatabase和观察器类MContactDbObserver封装了下并进行了一些优化，简便了我们操作时的一些代码，为此操作起来比较方便。
- CPbkContactItem（通讯录条目类）：该类头文件是CPbkContactItem.h，主要对通讯录条目类CContactItem的封装和优化，可以看出很多导出函数都是一致的。
- TPbkContactItemField（域类）：不用想也知道这个类是怎么来的了，该类的头文件tpbkcontactitemfield.h。有兴趣的可以去研究比照一下。
- 当然也有其他一些封装的类，只不过离通讯录模型比较远的，我们就不多展开了，在例子中看其使用。
例7、新建通讯录条目
/////////////////////////////////////////////////////////////////////////////////////////
_LIT(KFName,"King");
_LIT(KLName,"Chai");
_LIT(KNumber,"13777777777");
//运用引擎打开默认通讯录
CPbkContactEngine* iPbkContactEngine = CPbkContactEngine::NewL();
CleanupStack::PushL(PbkContactEngine);//1
//新建一空通信录项
CPbkContactItem* contact = iPbkContactEngine->CreateEmptyContactL();
CleanupStack::PushL(contact); //2
//设置first name 域
TPbkContactItemField* field = contact->FindField(EPbkFieldIdFirstName);
CleanupStack::PushL(contact); //3
field->TextStorage()->SetTextL(KFName);
//设置last name 域
field = contact->FindField(EPbkFieldIdLastName);
field->TextStorage()->SetTextL(KLName);
//设置手机号码域
field = contact->FindField(EPbkFieldIdPhoneNumberMobile);
field->TextStorage()->SetTextL(KNumber);
//可以添加其他值域
//...
//修改后结果添加到数据库中，并返回这个通信录项的id，该id可以以后使用
TContactItemId Id = iPbkContactEngine->AddNewContactL(*contact);
CleanupStack::PopAndDestroy(3);
/////////////////////////////////////////////////////////////////////////////////////////
以上代码是否比例4的代码相对来说更简单些啊？
例8、修改通讯录条目
实现修改和新建的代码类似，不同是你需要找到你要修改的通讯录条目aContactId，然后找到要修改的域进行修改，最后导入数据库。
/////////////////////////////////////////////////////////////////////////////////////////////
_LIT(number,"13500000000");
TBuf<11> phonenumber(number);
CPbkContactEngine* iPbkContactEngine = CPbkContactEngine::NewL();
CleanupStack::PushL(PbkContactEngine);//1
//这里打开条目后加锁，以防其它客户端打开
CPbkContactItem* contact = iPbkContactEngine->OpenContactLCX(aContactId);
CleanupStack::PushL(contact); //2
//找到需要修改的field
TPbkContactItemField* field = contact->FindField(EPbkFieldIdPhoneNumberMobile);
CleanupStack::PushL(field); //3
//设置并确认修改
field->TextStorage()->SetTextL(phonenumber);
iPbkContactEngine ->CommitContactL(*contact);
CleanupStack::PopAndDestroy(2)
/////////////////////////////////////////////////////////////////////////////////////////////
附录vCard：
手机应用开发中经常会遇到有关OBEX协议的问题，其实在通信录开发中也遵循这个协议，通信录中的数据是存在一个名叫vCard的载体里。vCard是一类电子名片，得到许多电子设备（如PDA和移动电话等）的支持。vCard的目的是：在这些设备之间用某些协议实现方便的通信录数据传递。可以将vCard编码成MIME规范（RFC 1521）所定义的明码文本。这种编码确保了各种vCard与限制为7位字符集（如在SMS消息中使用的编码）的传递编码的完全兼容。
一张vCard被格式化如下（说实话，下面这个vCard我也没看懂，有看懂的帮忙解释下）：
//////////////////////////////////////////////////////////////////////////////////////////////
BEGIN:VCARD
VERSION:2.1
N:Wilkinson;Steve
FN:Steve Wilkinson
ORG:EMCC Software Ltd.
TEL;WORK;VOICE:01617779700
ADR;WORK;ENCODING=QUOTED-PRINTABLE:;;108 Manchester
d.=0D=0ACarrington;Manchester;UK;M31 4BD;United Kingdom LABEL;WORK;ENCODING=QUOTED-PRINTABLE:108 Manchester Rd.=0D=0ACarrington=0D=0AManchester, UK M31 4BD=0D=0AUnited K= ingdom
EMAIL;PREF;INTERNET:steve.wilkinson@emccsoft.com
REV:20030909T164330Z
END:VCARD
//////////////////////////////////////////////////////////////////////////////////////////////
通信录模型中的许多功能都与vCard的处理有关，以保证 Symbian 应用开发伙伴们能方便地编制符合电子名片及通讯录交换方面的工业标准的代码。
From：http://www.drupaling.cn/a/shoujikaifa/Symbian/5318.html |
|
楼主
