iOS-----使用AddressBookUI管理联系人
使用AddressBookUI管理联系人
iOS SDK为管理地址簿提供的视图控制器位于AddressBookUI框架内。总结来说,AddressBookUI框架提供了如下特殊的视图控制器。
ABPersonViewController |
用于显示指定联系人数据的试图控制器 |
||||||||||
ABNewPersonViewController |
用于新增联系人的视图控制器 |
||||||||||
ABPeoplePickerViewController |
用于让用户选择某个联系人或选择某个联系人信息项的视图控制器 |
||||||||||
ABUnknownPersonViewController |
用于通过一组联系人信息来添加联系人记录,程序可以将该视图控制器显示的联系人信息存入手机通讯录中。实际上,该视图控制器可以对联系人数据启动这些标准动作:手机通话、发送通信、新增联系人、添加到已有联系人中。 |
||||||||||
这4个视图控制器的使用方式基本相同,都是先创建视图控制器的实例,并设置相关属性 -----关键是指定一个xxxDelegate属性,该属性值是一个实现特定协议的对象,该协议中定义的方法负责处理用户对视图控制器执行的操作。 |
|||||||||||
4个视图控制器对应的Delegate协议如下: |
|||||||||||
ABPersonViewControllerDelegate |
该协议包含一个必须实现的personViewController:shouldPerformDefaultActionForPerson:property:identifier:方法,当用户选中某个联系人的某个属性时激发该方法.如果希望用户选择该属性时自动执行它的默认动作,该方法应该返回YES;否则返回NO. |
||||||||||
ABPeoplePickerViewControllerDelegate |
该协议包含如下3个必须实现的方法. - peoplePickerNavigationController:shouldContinueAfterSelectingPerson:当用户通过该协议所对应的视图控制器选中某个联系人后激发该方法.如果希望用户选择该联系人后自动执行默认的动作,该方法应该返回YES;否则返回NO. - peoplePickerNavigationController:shouldContinueAfterSelectingPerson:property:identifier::当用户选中某个联系人的某个属性后激发该方法. 如果希望用户选择该联系人后自动执行默认的动作,该方法应该返回YES;否则返回NO. peoplePickerNavigationControllerDidCancel::当用户取消选择时激发该方法 |
||||||||||
ABUnknownPersonViewControllerDelegate |
该协议包含一个必须实现的unknownPersonViewController:didResolveToPerson:方法,当用户将未知联系人数据添加为新的联系人或保存到已有联系人中时激发该方法 |
||||||||||
这4个视图控制器还可以设置如下常用属性(有些属性不是每个控制器都支持的,具体以API文档为准).
|
使用ABNewPersonViewController添加联系人
addContact:方法将会使用ABNewPersonViewController添加联系人;unknown:方法将会使用ABUnknownPersonViewController显示未知联系人;pick:方法将会使用ABPersonPickerNavigationController让用户从联系人列表中选择联系人;view:方法将会使用ABPersonViewController显示指定联系人.
代 码 片 段 |
- (IBAction)addContact:(id)sender { // 创建ABNewPersonViewController视图控制器 ABNewPersonViewController *controller = [[ABNewPersonViewController alloc] init]; // 设置newPersonViewDelegate属性为当前视图控制器自身 controller.newPersonViewDelegate = self; // 使用UINavigationController包装ABNewPersonViewController UINavigationController *nav = [[UINavigationController alloc] initWithRootViewController:controller]; [self presentViewController:nav animated: YES completion: NULL]; } |
注意 |
为了让ABNewPersonViewController正常工作,通常需要使用UINavigationController来包装它 |
代码片段 |
// ABPersonViewControllerDelegate协议中的方法,当用户单击”保存”或”取消”按钮时激发该方法 - (void)newPersonViewController:(ABNewPersonViewController *)newPersonViewController didCompleteWithNewPerson:(ABRecordRef)person { // 如果用户单击”保存”按钮,person代表刚保存的记录 // 如果用户单击”取消”按钮,person为NULL if(person) { // 取出person记录中kABPersonFirstNameProperty属性的值 NSString *firstName = (__bridge NSString*)ABRecordCopyValue(person, kABPersonFirstNameProperty); [self showAlert:[NSString *stringWithFormat:@” [%@]联系人被保存 ”, firstName]]; } // 隐藏包装newPersonViewController的导航控制器 [newPersonViewController.navigationController dismissViewControllerAnimated:YES completion:NULL]; } |
使用ABUnknownPersonViewController显示未知联系人
系统将会激发unknown:事件处理方法,该方法将会使用ABUnknownPersonViewController显示一条刚刚新建的联系人的信息.下面是unknown:事件处理方法的代码
- (IBAction)unknown:(id)sender{ ABUnknownPersonViewController* controller = [[ABUnknownPersonViewController alloc] init ]; // 设置unknownPersonViewDelegate属性为当前视图控制器自身 controller. unknownPersonViewDelegate = self; // 设置显示标准动作 controller.allowsActions = YES; // 设置允许将该位置的联系人添加到地址簿 controller.allowsAddingToAddressBook = YES; // 创建一条新的记录 ABRecordRef record = ABPersonCreate(); // 为ABRecordRef记录设置kABPersonFirstNameProperty属性 ABRecordSetValue(record, kABPersonFirstNameProperty, (__bridge CFTypeRef)@”西游记”, NULL); // 为ABRecordRef记录设置kABPersonLastNameProperty属性 ABRecordSetValue(record, kABPersonLastNameProperty, (__bridge CFTypeRef)@”baidu.com”, NULL); // 添加联系人电话号码以及该号码对应的标签 ABMutableMultiValueRef multi = ABMultiValueCreateMutable(kABPersonPhoneProperty); ABMultiValueAddValueAndLabel(multi, (__bridge CFTypeRef)@””, (__bridge CFTypeRef)@”工作”, NULL); ABMultiValueAddValueAndLabel(multi, (__bridge CFTypeRef)@””, (__bridge CFTypeRef)@”手机”, NULL); // 为ABRecordRef记录设置kABPersonPhoneProperty属性 ABRecordSetValue(record, kABPersonPhoneProperty, multi , NULL); // 设置controller显示record记录 controller.displayedPerson = record; // 使用UINavigationController包装ABUnknownPersonViewController UINavigationController *nav = [[UINavigationController alloc] initWithRootViewController:controller]; [self presentViewController:nav animated: YES completion:NULL]; } 53// 注意:为了让ABUnknownPersonViewController正常工作,通常需要使用UINavigationController来包装它. // 视图控制器设置为ABUnknownPersonViewController的unknownPersonViewDelegate属性值,因此在视图控制器中必须实现ABUnknownPersonViewControllerDelegate协议,并实现如下方法 // ABUnknownPersonViewControllerDelegate协议中的方法 // 当用户把这条位置联系人信息添加到某个联系人上,或添加到地址簿中时将会激发该方法 - (void)unknownPersonViewController:(ABUnknownPersonViewController *)unknownPersonView didResolveToPerson:(ABRecordRef)person { // person代表用户刚刚保存的记录 if(person) { // 取出person记录中kABPersonFirstNameProperty属性值 NSString *firstName = (__bridge NSString*)ABRecordCopyValue(person, kABPersonFirstNameProperty); [self showAlert:[NSString stringWithFormat:@”[%@]联系人保存”, firstName]]; } // 隐藏包装unknownPersonView的导航控制器 [unknownPersonView.navigationController dismissViewControllerAnimated:YES completion:NULL]; }
使用ABPeoplePickerNavigationController选择联系人
用户单击界面上的”选择联系人”按钮,系统将会激发pick:事件处理方法,该方法将会使用ABPeoplePickerNavigationController显示联系人列表供用户选择.下面是pick:事件处理方法的代码
- (IBAction)pick:(id)sender { ABPeoplePickerNavigationController* controller = [[ABPepplePickerNavigationController alloc] init]; // 设置peoplePickerDelegate属性为当前视图控制器自身 controller.peoplePickerDelegate = self; [self presentViewController:controller animated:YES completion:NULL]; } 从上面的代码可以看出,ABPeoplePickerNavigationController的用法更为简单------创建该类的实例,设置peoplePickerDelegate属性,然后将它显示出来即可. 实现ABPeoplePickerNavigationControllerDelegate协议,并实现如下方法 - (BOOL)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker shouldContinueAfterSelectingPerson:(ABRecordRef)person { // 取消显示peoplePicker视图控制器 // 当peoplePicker视图控制器 [peoplePicker dismissViewControllerAnimated:YES completion:^{ // 创建ABPersonViewController视图控制器 // 取出person记录中kABPersonFirstNameProperty属性值 NSString *firstName = (__bridge NSString*)ABRecordCopyValue(person, kABPersonFirstNameProperty); [self showAlert:[NSString stringWithFormat:@”您选中了[%@]联系人”, firstName]]; }]; return NO; } - (BOOL)peoplePickerNavigationController:(ABPeoplePickerNavigationController*)peoplePickershouldContinueAfterSelectingPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier { return NO; } - (void)peoplePickerNavigationControllerDidCancel: (ABPeoplePickerNavigationController*)peoplePicker { NSLog(@”用户取消了选择”); }
使用ABPersonViewController显示指定联系人
当用户单击程序界面上的”查看ID为1的联系人”按钮时,程序将会激发view:方法,该方法将会使用ABPersonViewController显示指定联系人.限免是view:事件处理方法的代码.
- (IBAction)view:(id)sender { ABAddressBookRef ab = ABAddressBookCreateWithOptions(NULL, NULL); // 获取ID为1的联系人记录 ABRecordRef rec = ABAddressBookGetPersonWithRecordID(ab, ); // 创建ABPersonViewController视图控制器 ABPersonViewController* controller = [[ABPersonViewController alloc] init]; controller.allowsActions = YES; controller.allowsEditing = YES; controller.personViewDelegate = self; // 显示用户选中的联系人记录 controller.displayedPerson = rec; // 使用UINavigationController包装ABPersonViewController UINavigationController* nav = [[UINavigationController alloc] initWithRootViewController:controller]; [self persentViewController: nav animated: YES completion: NULL]; } 实现ABPersonViewControllerDelegate协议,并实现该协议中定义的如下方法. // 当用户选中某个属性时激发该方法 - (BOOL)peopleViewController:(ABPeopleViewController *)personViewController shouldPerformDefaultActionForPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier { [self showAlert:[NSString stringWithFormat:@”名字为:%@”, (__bridge NSString*)ABRecordCopyCompositeName(person)]]; [personViewController.navigationController dismissViewControllerAnimated:YES completion:NULL]; return YES; }
iOS-----使用AddressBookUI管理联系人的更多相关文章
- iOS-----使用AddressBook管理联系人
使用AddressBook管理联系人 iPhone手机通常都是自带的Contacts应用,包括所有联系人的性(last name).名(first name).电话.E-mail地址.住址.生日等各种 ...
- 理解 iOS 的内存管理
远古时代的故事 那些经历过手工管理内存(MRC)时代的人们,一定对 iOS 开发中的内存管理记忆犹新.那个时候大约是 2010 年,国内 iOS 开发刚刚兴起,tinyfool 大叔的大名已经如雷贯耳 ...
- iOS ARC内存管理
iOS的内存管理机制,只要是iOS开发者,不管多长的时间经验,都能说出来一点,但是要深入的理解.还是不简单的.随着ARC(自动管理内存)的流行.iOS开发者告别了手动管理内存的复杂工作.但是自动管理内 ...
- android管理联系人操作
ContentProvider扩展之管理系统联系人 我们都知道ContentProvider是用来共享数据的,然而android本身就提供了大量的ContentProvider,例如联系人信息,系统的 ...
- iOS之内存管理(ARC)
iOS的内存管理,相信大家都不陌生,之前是使用的MRC,由开发人员手动来管理内存,后来使用了ARC,来由系统管理内存.本文主要讲讲Autorelease,Core Foundation对象在内存管理方 ...
- iOS-----使用addressBook管理联系人之修改联系人
使用addressBook管理联系人之修改联系人 修改联系人 修改联系人先从底层地址簿中加载一条ABRecordRef记录,然后对这条ABRecordRef记录的属性值进行修改,修改完成后把这条修改后 ...
- IOS开发依赖管理工具CocoaPods
CocoaPods IOS开发依赖管理工具 CocoaPods is a dependency manager for Swift and Objective-C Cocoa projects. It ...
- 说说iOS与内存管理(上)
http://www.cocoachina.com/ios/20150625/12234.html 说起内存管理,看似老生常谈,而真正掌握内存管理的核心其实并不简单.ARC/MRR以及“谁分配谁就负责 ...
- iOS的内存管理和引用计数规则、Block的用法以及三种形式(stack、malloc、global)
学习内容 iOS的内存管理和引用计数规则 内存管理的思考方式 自己生成的对象自己持有 非自己生成的对象自己也能持有 自己持有的对象不需要时释放 非自己持有的对象不能释放 ARC有效时,id类型和对象类 ...
随机推荐
- 基于Kafka+Spark Streaming+HBase实时点击流案例
背景 Kafka实时记录从数据采集工具Flume或业务系统实时接口收集数据,并作为消息缓冲组件为上游实时计算框架提供可靠数据支撑,Spark 1.3版本后支持两种整合Kafka机制(Receiver- ...
- python3 requests 进行接口测试、爬虫使用总结
Requests 是第三方模块,如果要使用的话需要导入.Requests也可以说是urllib模块的升级版,使用上更方便. 这是使用urllib的例子. import urllib.request i ...
- C++ string 类
标准c++中string类函数介绍 注意不是CString之所以抛弃char*的字符串而选用C++标准程序库中的string类,是因为他和前者比较起来,不必 担心内存是否足够.字符串长度等等,而且作为 ...
- Linux系统——Inotify事件监控工具
每秒传输文件200个 Rsync放在定时任务中也只是一分钟执行一回,要想达到实时的效果,为防止单点nfs架构故障,再启动一台nfs服务器作为主nfs服务器的备份服务器,此时需要inotify实时同步数 ...
- 002-mybatis主配置文件
<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE configuration PUBLIC & ...
- [翻译] Rails::Railtie
原文:http://api.rubyonrails.org/classes/Rails/Railtie.html Railtie 是 Rails 框架的核心,提供几个钩子来扩展或修改 Rails 的 ...
- 2018 Multi-University Training Contest 7 Solution
A - Age of Moyu 题意:给出一张图,从1走到n,如果相邻两次走的边的权值不同,花费+1, 否则花费相同,求最小花费 思路:用set记录有当前点的最小花费有多少种方案到达,然后最短路 #i ...
- poj1673 EXOCENTER OF A TRIANGLE
地址:http://poj.org/problem?id=1673 题目: EXOCENTER OF A TRIANGLE Time Limit: 1000MS Memory Limit: 100 ...
- 20155333 2016-2017-2 《Java程序设计》第七周学习总结
20155333 2016-2017-2 <Java程序设计>第七周学习总结 教材学习内容总结 Lambda 教材的引入循序渐近.深入浅出 Lambda去重复,回忆DRY原则 Lambda ...
- 文件名含中文的JavaWeb文件下载
在javaweb项目中实现文件下载,当文件名中包含中文文字时,需要进行如下的处理,才能在浏览器端正常显示中文文件名: response.setContentType("octets/stre ...