使用AddressBookUI管理联系人

iOS SDK为管理地址簿提供的视图控制器位于AddressBookUI框架内。总结来说，AddressBookUI框架提供了如下特殊的视图控制器。

使用ABNewPersonViewController添加联系人

addContact:方法将会使用ABNewPersonViewController添加联系人;unknown:方法将会使用ABUnknownPersonViewController显示未知联系人;pick:方法将会使用ABPersonPickerNavigationController让用户从联系人列表中选择联系人;view:方法将会使用ABPersonViewController显示指定联系人.

使用ABUnknownPersonViewController显示未知联系人

系统将会激发unknown:事件处理方法,该方法将会使用ABUnknownPersonViewController显示一条刚刚新建的联系人的信息.下面是unknown:事件处理方法的代码

 1 - (IBAction)unknown:(id)sender{
 2 
 3   ABUnknownPersonViewController* controller = [[ABUnknownPersonViewController alloc] init ];
 4 
 5 // 设置unknownPersonViewDelegate属性为当前视图控制器自身
 6 
 7 controller. unknownPersonViewDelegate = self;
 8 
 9 // 设置显示标准动作
10 
11 controller.allowsActions = YES;
12 
13 // 设置允许将该位置的联系人添加到地址簿
14 
15 controller.allowsAddingToAddressBook = YES;
16 
17 // 创建一条新的记录
18 
19 ABRecordRef record = ABPersonCreate();
20 
21 // 为ABRecordRef记录设置kABPersonFirstNameProperty属性
22 
23 ABRecordSetValue(record,  kABPersonFirstNameProperty,  (__bridge CFTypeRef)@”西游记”, NULL);
24 
25 // 为ABRecordRef记录设置kABPersonLastNameProperty属性
26 
27 ABRecordSetValue(record,  kABPersonLastNameProperty,  (__bridge CFTypeRef)@”baidu.com”, NULL);
28 
29 // 添加联系人电话号码以及该号码对应的标签
30 
31 ABMutableMultiValueRef  multi = ABMultiValueCreateMutable(kABPersonPhoneProperty);
32 
33 ABMultiValueAddValueAndLabel(multi, (__bridge CFTypeRef)@”02028309358”, (__bridge CFTypeRef)@”工作”, NULL);
34 
35 ABMultiValueAddValueAndLabel(multi, (__bridge CFTypeRef)@”13500008888”, (__bridge CFTypeRef)@”手机”, NULL);
36 
37 // 为ABRecordRef记录设置kABPersonPhoneProperty属性
38 
39 ABRecordSetValue(record,  kABPersonPhoneProperty, multi , NULL);
40 
41 // 设置controller显示record记录
42 
43 controller.displayedPerson = record;
44 
45 // 使用UINavigationController包装ABUnknownPersonViewController
46 
47 UINavigationController *nav = [[UINavigationController alloc] initWithRootViewController:controller];
48 
49 [self presentViewController:nav animated: YES  completion:NULL];
50 
51 }
52 
53//  注意:为了让ABUnknownPersonViewController正常工作,通常需要使用UINavigationController来包装它.
54 
55 // 视图控制器设置为ABUnknownPersonViewController的unknownPersonViewDelegate属性值,因此在视图控制器中必须实现ABUnknownPersonViewControllerDelegate协议,并实现如下方法
56 
57 // ABUnknownPersonViewControllerDelegate协议中的方法
58 
59 // 当用户把这条位置联系人信息添加到某个联系人上,或添加到地址簿中时将会激发该方法
60 
61 - (void)unknownPersonViewController:(ABUnknownPersonViewController *)unknownPersonView  didResolveToPerson:(ABRecordRef)person
62 
63 {
64 
65    // person代表用户刚刚保存的记录
66 
67   if(person)
68 
69 {
70 
71 //  取出person记录中kABPersonFirstNameProperty属性值
72 
73 NSString *firstName = (__bridge NSString*)ABRecordCopyValue(person, kABPersonFirstNameProperty);
74 
75 [self  showAlert:[NSString stringWithFormat:@”[%@]联系人保存”, firstName]];
76 
77 }
78 
79 // 隐藏包装unknownPersonView的导航控制器
80 
81 [unknownPersonView.navigationController  dismissViewControllerAnimated:YES completion:NULL];
82 
83 }

使用ABPeoplePickerNavigationController选择联系人

用户单击界面上的”选择联系人”按钮,系统将会激发pick:事件处理方法,该方法将会使用ABPeoplePickerNavigationController显示联系人列表供用户选择.下面是pick:事件处理方法的代码

 1 - (IBAction)pick:(id)sender
 2 
 3 {
 4 
 5    ABPeoplePickerNavigationController* controller = [[ABPepplePickerNavigationController alloc] init];
 6 
 7    // 设置peoplePickerDelegate属性为当前视图控制器自身
 8 
 9    controller.peoplePickerDelegate = self;
10 
11    [self presentViewController:controller animated:YES completion:NULL];
12 
13 }
14 
15 从上面的代码可以看出,ABPeoplePickerNavigationController的用法更为简单------创建该类的实例,设置peoplePickerDelegate属性,然后将它显示出来即可.
16 
17 实现ABPeoplePickerNavigationControllerDelegate协议,并实现如下方法
18 
19 - (BOOL)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker shouldContinueAfterSelectingPerson:(ABRecordRef)person
20 
21 {
22 
23    // 取消显示peoplePicker视图控制器
24 
25    // 当peoplePicker视图控制器
26 
27    [peoplePicker dismissViewControllerAnimated:YES completion:^{
28 
29   // 创建ABPersonViewController视图控制器
30 
31   // 取出person记录中kABPersonFirstNameProperty属性值
32 
33   NSString *firstName = (__bridge NSString*)ABRecordCopyValue(person, kABPersonFirstNameProperty);
34 
35   [self showAlert:[NSString stringWithFormat:@”您选中了[%@]联系人”, firstName]];
36 
37 }];
38 
39 return NO;
40 
41 }
42 
43 - (BOOL)peoplePickerNavigationController:(ABPeoplePickerNavigationController*)peoplePickershouldContinueAfterSelectingPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier
44 
45 {
46 
47    return NO;
48 
49 }
50 
51 - (void)peoplePickerNavigationControllerDidCancel: (ABPeoplePickerNavigationController*)peoplePicker
52 
53 {
54 
55   NSLog(@”用户取消了选择”);
56 
57 }

使用ABPersonViewController显示指定联系人

当用户单击程序界面上的”查看ID为1的联系人”按钮时,程序将会激发view:方法,该方法将会使用ABPersonViewController显示指定联系人.限免是view:事件处理方法的代码.

 1 - (IBAction)view:(id)sender
 2 
 3 {
 4 
 5   ABAddressBookRef ab = ABAddressBookCreateWithOptions(NULL, NULL);
 6 
 7   // 获取ID为1的联系人记录
 8 
 9   ABRecordRef rec = ABAddressBookGetPersonWithRecordID(ab, 1);
10 
11   // 创建ABPersonViewController视图控制器
12 
13  ABPersonViewController* controller = [[ABPersonViewController alloc] init];
14 
15  controller.allowsActions = YES;
16 
17  controller.allowsEditing = YES;
18 
19  controller.personViewDelegate = self;
20 
21  // 显示用户选中的联系人记录
22 
23 controller.displayedPerson = rec;
24 
25 // 使用UINavigationController包装ABPersonViewController
26 
27 UINavigationController* nav = [[UINavigationController alloc] initWithRootViewController:controller];
28 
29 [self persentViewController: nav animated: YES completion: NULL];
30 
31 }
32 
33 实现ABPersonViewControllerDelegate协议,并实现该协议中定义的如下方法.
34 
35 // 当用户选中某个属性时激发该方法
36 
37  
38 
39 - (BOOL)peopleViewController:(ABPeopleViewController *)personViewController shouldPerformDefaultActionForPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier
40 
41 {
42 
43   [self showAlert:[NSString stringWithFormat:@”名字为:%@”, (__bridge NSString*)ABRecordCopyCompositeName(person)]];
44 
45   [personViewController.navigationController dismissViewControllerAnimated:YES completion:NULL];
46 
47  return YES;
48 
49 }