使用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 }