在需要的情况下,可以通过相关的API来访问手机上的联系人信息;当然,在不必要的情况下,不要随便去获取别人的数据。
要从联系人列表中选择并获取一位或者N位联系人的详细信息,比较简单的做法是利用ContactPicker。该类会弹出系统集成的联系人选择界面,用户直接通过界面操作选择需要的联系人。当用户做出选择后,会将选择结果返回给调用方。
一位联系人的具体信息由Contact类封装,比如手机号码、姓名、住址等,有关该类的具体成员我就不一一说了,那样多没意思,用VS的人都应该经常打开“对象浏览器”窗口玩玩,这个窗口非常好玩,经常会遇到不少人老喜欢问:XXX类在哪个命名空间下? 岂有此理!你是第一天用VS吗? 自己不会打开“对象浏览器”去看看吗? 所以,以后我的博文中不会再告诉你某个类在哪个命名空间下,你自己要知道如何去找。
使用ContactPicker类来选择联系人非常简单,用下面的例子演示一下你就会明白了。
这个例子用两个RadioButton控件做选择,即选择单个联系人还是选择多个。
<Grid> <Grid.RowDefinitions> <RowDefinition Height="auto"/> <RowDefinition/> </Grid.RowDefinitions> <StackPanel Orientation="Vertical"> <Button Content="选择联系人" Click="PickContacts"/> <RadioButton Name="rdbSingle" Content="选择单个" IsChecked="True" GroupName="g1"/> <RadioButton Name="rdbMulti" Content="选择多个" GroupName="g1"/> </StackPanel> <ListBox Name="lb" Grid.Row="1" Margin="5"> <ListBox.ItemTemplate> <DataTemplate> <StackPanel> <TextBlock Foreground="Green" FontSize="26" Text="{Binding DisplayName}"/> <ItemsControl Margin="7,0,0,0" ItemsSource="{Binding Phones }"> <ItemsControl.ItemTemplate> <DataTemplate> <TextBlock FontSize="20"> 手机:<Run Text="{Binding Number}"/> </TextBlock> </DataTemplate> </ItemsControl.ItemTemplate> </ItemsControl> </StackPanel> </DataTemplate> </ListBox.ItemTemplate> </ListBox> </Grid>
ListBox控件用来显示被选择的联系人的信息,例子中,我只显示DisplayName(显示名)和Phones(手机号码列表)两个字段,其他就不列举了,这样简洁一点。
下面代码将使用ContactPicker来选择联系人。
ContactPicker _contactPicker = new ContactPicker(); // 必须设置以下项 _contactPicker.DesiredFieldsWithContactFieldType.Add(ContactFieldType.PhoneNumber); // 选择单个联系人 if (rdbSingle.IsChecked == true) { Contact singleContact = await _contactPicker.PickContactAsync(); if (singleContact != null) { IList<Contact> contacts = new List<Contact>(); contacts.Add(singleContact); lb.ItemsSource = contacts; } } // 选择多个联系人 if (rdbMulti.IsChecked == true) { lb.ItemsSource = await _contactPicker.PickContactsAsync(); }
建议在每次使用的时候才实例化ContactPicker,不要在页面类级别实例化,因为当用户选择完联系人后,系统会将ContactPicker实例中的某些内容清理,当第二次访问时就会发生异常。我们知道,RT的API其实是以COM形式出现的,只是用托管代码进行了封装。
说到这里,又想起一件事,前不久看到有人怀疑WPF是否被RT取代的言论。其实那不准,RT程序主要面向像ARM一些移动CPU的,或者说它专用于移动终端平台,像平板手机等;而WPF是用于桌面环境的,之所以会从WPF产生像RT这样的子集,就是考虑到移动终端是不能和桌面系统相比的,CPU架构也存在不同。哪怕是相同参数的CPU,移动版的性能其实是缩水的,不能与PC上的CPU比,应该要区分它们的用途。
不管怎样,.net上的各种东西都是一脉相承的,你只要有扎实的WPF基础,那么在Silverligt、RT等内容上你几乎不需要学习就可以马上开工。任何事物都是处于不断变化之中,.NET不管它怎么更新,其主要的东西是不变的,所以有些人总感觉学习成本高。我告诉你,你觉得学习成本高,那是因为你本身基础就不扎实,而且这种不扎实还会随着时间一点一点地积累的。如果你在学习.net的时候注重打基本功,无论它怎么变,对你来说影响是不大的,要学会知识迁移。
我用一句话总结一下,学会以下几个东西,基本上.net就没问题了——编程语言基础 + WCF、WPF、ASP.NET。
不扯废话了,回归话题。在ContactPicker的时候,有两个方法可以选择:
1、PickContactAsync:只选择一个联系人,返回单个Contact实例。
2、PickContactsAsync:多选。返回一个Contact列表,表示已被选择的联系人。
以下代码是必须的,如果没有会发生异常:
// 必须设置以下项
_contactPicker.DesiredFieldsWithContactFieldType.Add(ContactFieldType.PhoneNumber);
ContactFieldType指定以什么类型去选取联系人,你至少要Add一个,我这里只用到PhoneNumber,表示选择是以联系人的电话号码为基准的,如果是Email,就表示以选取电邮地址为基准,通常是选择电话号码多一些。
现在,可以测试一下。
===================================================
以上方法尽管比吃西瓜还简单,但似乎缺少了些灵活性。尤其是我们希望想通过自己设计的UI来显示、查找联系人的时候,就不应该再使用系统默认的选择器。
因此,可以使用另一种方法来获取联系人信息,这种方法是”无界面“的,而是直接通过代码来获取,这样我们可以自己来设计显示联系人列表的界面,或者可以加入自己的搜索功能。
ContactStore公开以下几个方法,可以获取联系人信息。
FindContactsAsync:方法有两个重载,不带任何参数的重载将获取所有联系人;带一个string参数的版本可以根据参数进行搜索,比如,联系人列表存在以下三个人:毛线、毛丫子、苟毛,那么当调用FindContactsAsync方法并把字符串”毛“传递进去后,就会返回这三个联系人信息。
利用这点,我们就可以实现自己的搜索功能。比如下面XAML:
<Grid> <Grid.RowDefinitions> <RowDefinition Height="auto"/> <RowDefinition Height="*"/> </Grid.RowDefinitions> <TextBox Name="txtInput" TextChanged="OnTextChanged"/> <ListView x:Name="lv" Grid.Row="1" ItemClick="OnItemClick" IsItemClickEnabled="True"> <ListView.ItemTemplate> <DataTemplate> <TextBlock FontSize="24" Text="{Binding DisplayName}"/> </DataTemplate> </ListView.ItemTemplate> </ListView> </Grid>
TextBox用于输入搜索关键字,通过处理TextChanged事件,可以在输入的文本发生变化后立即完成搜索,并将搜到的结果显示在ListView控件中。ListView中只显示搜到的联系人的显示名,当用户点击ListView中的项时,会把该联系人的ID、姓名、手机号码显示在TextBlock中。
private async void OnTextChanged ( object sender, TextChangedEventArgs e ) { IReadOnlyList<Contact> contacts = null; if (string.IsNullOrWhiteSpace(txtInput.Text)) { // 如果输入为空,就查找所有联系人 contacts = await _store.FindContactsAsync(); } else { contacts = await _store.FindContactsAsync(txtInput.Text); } lv.ItemsSource = contacts; }
ContactStore类在使用前并不能直接实例化,它是通过ContactManager类的RequestStoreAsync静态方法返回。
_store = await ContactManager.RequestStoreAsync();
使用这种方法获取联系人信息,请必须打开清单文件,在”功能“选项卡下勾选”联系人“,然后保存,否则应用程序无权限访问联系人。
好了,现在再看看这个例子的结果。
下面是本文两个示例的源代码下载地址:
http://files.cnblogs.com/tcjiaan/sampleSrcs.zip
关于联系人管理,下一篇文章再向大家介绍有点复杂的第三种方案。