如何使用iOS AddressBook
一.基本知識(shí)
和通訊錄中聯(lián)系人相關(guān)的應(yīng)用iPhone提供了兩個(gè)框架:AddressBook.framework和AddressBookUI.framework,使用這兩個(gè)框架我們可以在程序中訪問并顯示iPhone數(shù)據(jù)庫中的聯(lián)系人信息。
二.具體介紹
1.AddressBookUI顯示部分
AddressBookUI中提供了和聯(lián)系人顯示信息相關(guān)的一些Controller,有四個(gè):
ABPeoplePickerNavigationController:顯示整個(gè)通訊錄并可以選擇一個(gè)聯(lián)系人的信息
ABPersonViewController:顯示一個(gè)具體聯(lián)系人的信息
ABNewPersonViewController:增加一個(gè)新的聯(lián)系人
ABUnknownPersonViewController:完善一個(gè)聯(lián)系人的信息
由于其中最主要的是ABPeoplePickerNavigationController,因此就具體的介紹一下通過程序顯示整個(gè)通訊錄并且可以選擇其中某個(gè)聯(lián)系人信息的步驟。
(a)創(chuàng)建并初始化一個(gè)ABPeoplePickerNavigationController對(duì)象
(b)設(shè)置其代理(delegate)
(c)用presentModalViewController:animated:這個(gè)方法進(jìn)行顯示整個(gè)通訊錄頁面
例子:
- (IBAction)showPicker:(id)sender {ABPeoplePickerNavigationController *picker = [[ABPeoplePickerNavigationController alloc] init];
picker.peoplePickerDelegate = self;
[self presentModalViewController:picker animated:YES];
[picker release];
}
ABPeoplePickerNavigationControllerDelegate的方法介紹
(a)peoplePickerNavigationControllerDidCancel:當(dāng)用戶選擇取消時(shí)調(diào)用這個(gè)方法,可以在這個(gè)方法里取消整個(gè)通訊錄頁面的顯示。
(b)peoplePickerNavigationController:shouldContinueAfterSelectingPerson: 當(dāng)用戶選擇了通訊錄中某一個(gè)聯(lián)系人時(shí)調(diào)用這個(gè)方法,可以在這里獲取聯(lián)系人的信息。如果希望可以繼續(xù)顯示這個(gè)聯(lián)系人更具體的信息,則return YES。否則取消整個(gè)通訊錄頁面的顯示并return NO。
(c)peoplePickerNavigationController:shouldContinueAfterSelectingPerson:property:identifier:?如果上一個(gè)方法返回的是YES,則會(huì)顯示某一個(gè)聯(lián)系人信息,如果選擇了聯(lián)系人的某一項(xiàng)紀(jì)錄,就會(huì)調(diào)用這個(gè)方法,可以通過點(diǎn)擊選擇聯(lián)系人的某一項(xiàng)信息。如果 希望可以對(duì)選擇的某一項(xiàng)紀(jì)錄進(jìn)行進(jìn)一步操作,比如直接撥打電話或調(diào)用郵箱發(fā)送郵件,則return YES。否則取消整個(gè)通訊錄頁面的顯示并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{
//獲取聯(lián)系人姓名
name.text = (NSString*)ABRecordCopyCompositeName(person);
//獲取聯(lián)系人電話
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);
}
//獲取聯(lián)系人郵箱 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 *)peoplePickershouldContinueAfterSelectingPerson:(ABRecordRef)person property:(ABPropertyID)property
identifier:(ABMultiValueIdentifier)identifier
{
return NO;
}
2.AddressBook部分
AddressBook框架部分主要是記錄聯(lián)系人的各個(gè)信息,ABRecordRef類型的記錄既可以代表單個(gè)人(kABPersonType),也可以是一個(gè)集合(kABGroupType)。
通訊錄中聯(lián)系人的各個(gè)屬性有兩種形式,單值屬性和多值屬性。單值屬性對(duì)應(yīng)的只有一個(gè)值,比如聯(lián)系人的姓名;多值屬性對(duì)應(yīng)的可能有多個(gè)值,比如聯(lián)系人有多個(gè)電話號(hào)碼等。
(a)常用方法
CFTypeRef ABRecordCopyValue (
?? ABRecordRef record,
?? ABPropertyID property
);
從一個(gè)記錄中獲取某個(gè)屬性對(duì)應(yīng)的值
(b)單值屬性對(duì)應(yīng)的方法
CFStringRef ABRecordCopyCompositeName (
?? ABRecordRef record
);
獲取聯(lián)系人完整的姓名。
(c)多值屬性對(duì)應(yīng)的方法
CFTypeRef ABMultiValueCopyValueAtIndex (
?? ABMultiValueRef multiValue,
?? CFIndex index
);
返回對(duì)應(yīng)位置處的屬性值
CFStringRef ABMultiValueCopyLabelAtIndex (
?? ABMultiValueRef multiValue,
?? CFIndex index
);
返回對(duì)應(yīng)位置處的屬性標(biāo)識(shí)
CFArrayRef ABMultiValueCopyArrayOfAllValues (
?? ABMultiValueRef multiValue
);
返回包含所有屬性值的數(shù)組
CFIndex ABMultiValueGetCount (
?? ABMultiValueRef multiValue
);
返回屬性值的個(gè)數(shù)
總結(jié)
以上是生活随笔為你收集整理的如何使用iOS AddressBook的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: IOS学习之蓝牙4.0
- 下一篇: AddressBookUI.Framwo