一.基本知識
和通訊錄中聯系人相關的應用iPhone提供了兩個框架:AddressBook.framework和AddressBookUI.framework,使用這兩個框架我們可以在程序中訪問並顯示iPhone數據庫中的聯系人信息。
二.具體介紹
1.AddressBookUI顯示部分
AddressBookUI中提供了和聯系人顯示信息相關的一些Controller,有四個:
ABPeoplePickerNavigationController:顯示整個通訊錄並可以選擇一個聯系人的信息
ABPersonViewController:顯示一個具體聯系人的信息
ABNewPersonViewController:增加一個新的聯系人
ABUnknownPersonViewController:完善一個聯系人的信息
由於其中最主要的是ABPeoplePickerNavigationController,因此就具體的介紹一下通過程序顯示整個通訊錄並且可以選擇其中某個聯系人信息的步驟。
(a)創建並初始化一個ABPeoplePickerNavigationController對象
(b)設置其代理(delegate)
(c)用presentModalViewController:animated:這個方法進行顯示整個通訊錄頁面
例子:
- (IBAction)showPicker:(id)sender {
ABPeoplePickerNavigationController *picker = [[ABPeoplePickerNavigationController alloc] init];
picker.peoplePickerDelegate = self;
[self presentModalViewController:picker animated:YES];
[picker release];
}
ABPeoplePickerNavigationControllerDelegate的方法介紹
(a)peoplePickerNavigationControllerDidCancel:當用戶選擇取消時調用這個方法,可以在這個方法里取消整個通訊錄頁面的顯示。
(b)peoplePickerNavigationController:shouldContinueAfterSelectingPerson: 當用戶選擇了通訊錄中某一個聯系人時調用這個方法,可以在這里獲取聯系人的信息。如果希望可以繼續顯示這個聯系人更具體的信息,則return YES。否則取消整個通訊錄頁面的顯示並return NO。
(c)peoplePickerNavigationController:shouldContinueAfterSelectingPerson:property:identifier: 如果上一個方法返回的是YES,則會顯示某一個聯系人信息,如果選擇了聯系人的某一項紀錄,就會調用這個方法,可以通過點擊選擇聯系人的某一項信息。如果 希望可以對選擇的某一項紀錄進行進一步操作,比如直接撥打電話或調用郵箱發送郵件,則return YES。否則取消整個通訊錄頁面的顯示並return NO。
例子:
(a)示例:
- (void)peoplePickerNavigationControllerDidCancel:(ABPeoplePickerNavigationController *)peoplePicker {
// assigning control back to the main controller
[picker dismissModalViewControllerAnimated:YES];
}
(b)示例:
- (BOOL)peoplePickerNavigationController: (ABPeoplePickerNavigationController *)peoplePicker shouldContinueAfterSelectingPerson:(ABRecordRef)person
{
//獲取聯系人姓名
name.text = (NSString*)ABRecordCopyCompositeName(person);
//獲取聯系人電話
ABMutableMultiValueRef phoneMulti = ABRecordCopyValue(person, kABPersonPhoneProperty);
NSMutableArray *phones = [[NSMutableArray alloc] init];
int i;
for (i = 0; i < ABMultiValueGetCount(phoneMulti); i++)
{
NSString *aPhone = [(NSString*)ABMultiValueCopyValueAtIndex(phoneMulti, i) autorelease];
NSString *aLabel = [(NSString*)ABMultiValueCopyLabelAtIndex(phoneMulti, i) autorelease];
NSLog(@"PhoneLabel:%@ Phone#:%@",aLabel,aPhone);
if([aLabel isEqualToString:@"_$!<Mobile>!$_"])
{
[phones addObject:aPhone];
}
}
phoneNo.text=@"";
if([phones count]>0)
{
NSString *mobileNo = [phones objectAtIndex:0];
phoneNo.text = mobileNo;
//NSLog(mobileNo);
}
//獲取聯系人郵箱
ABMutableMultiValueRef emailMulti = ABRecordCopyValue(person, kABPersonEmailProperty);
NSMutableArray *emails = [[NSMutableArray alloc] init];
for (i = 0;i < ABMultiValueGetCount(emailMulti); i++)
{
NSString *emailAdress = [(NSString*)ABMultiValueCopyValueAtIndex(emailMulti, i) autorelease];
[emails addObject:emailAdress];
}
email.text=@"";
if([emails count]>0)
{
NSString *emailFirst=[emails objectAtIndex:0];
email.text = emailFirst;
//NSLog(emailFirst);
}
[peoplePicker dismissModalViewControllerAnimated:YES];
return NO;
}
(c)示例
- (BOOL)peoplePickerNavigationController: (ABPeoplePickerNavigationController *)peoplePicker
shouldContinueAfterSelectingPerson:(ABRecordRef)person property:(ABPropertyID)property
identifier:(ABMultiValueIdentifier)identifier
{
return NO;
}
2.AddressBook部分
AddressBook框架部分主要是記錄聯系人的各個信息,ABRecordRef類型的記錄既可以代表單個人(kABPersonType),也可以是一個集合(kABGroupType)。
通訊錄中聯系人的各個屬性有兩種形式,單值屬性和多值屬性。單值屬性對應的只有一個值,比如聯系人的姓名;多值屬性對應的可能有多個值,比如聯系人有多個電話號碼等。
(a)常用方法
CFTypeRef ABRecordCopyValue (
ABRecordRef record,
ABPropertyID property
);
從一個記錄中獲取某個屬性對應的值
(b)單值屬性對應的方法
CFStringRef ABRecordCopyCompositeName (
ABRecordRef record
);
獲取聯系人完整的姓名。
(c)多值屬性對應的方法
CFTypeRef ABMultiValueCopyValueAtIndex (
ABMultiValueRef multiValue,
CFIndex index
);
返回對應位置處的屬性值
CFStringRef ABMultiValueCopyLabelAtIndex (
ABMultiValueRef multiValue,
CFIndex index
);
返回對應位置處的屬性標識
CFArrayRef ABMultiValueCopyArrayOfAllValues (
ABMultiValueRef multiValue
);
返回包含所有屬性值的數組
CFIndex ABMultiValueGetCount (
ABMultiValueRef multiValue
);
返回屬性值的個數