首页 / 软件开发 / .NET编程技术 / Windows 8 Store Apps学习（27） 选取器: 联系人选取窗口

Windows 8 Store Apps学习（27） 选取器: 联系人选取窗口2013-12-06 cnblogs webabcd选取器: 联系人选取窗口, 自定义联系人选取窗口

介绍

重新想象 Windows 8 Store Apps 之 选取器

ContactPicker - 联系人选取器

ContactPickerUI - 自定义联系人选取器

示例

演示如何通过 ContactPicker 选择一个或多个联系人 ，以及如何开发自定义联系人选取器

1、 开发一个自定义联系人选取器

Picker/MyContactPicker.xaml

<Pagex:Class="XamlDemo.Picker.MyContactPicker"xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"xmlns:local="using:XamlDemo.Picker"xmlns:d="http://schemas.microsoft.com/expression/blend/2008"xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"mc:Ignorable="d"><Grid Background="Transparent"><StackPanel Margin="120 0 0 0"><TextBlock Name="lblMsg" FontSize="14.667" /><Button Name="btnAddContract" Content="增加一个联系人" Click="btnAddContract_Click" Margin="0 10 0 0" /></StackPanel></Grid></Page>

Picker/MyContactPicker.xaml.cs

/* * 演示如何开发自定义的联系人选取器 ** 1、在 Package.appxmanifest 中新增一个“联系人选取器”声明，并做相关配置 * 2、在 App.xaml.cs 中 override void OnActivated（IActivatedEventArgs args），以获取联系人选取器的相关信息 ** ContactPickerActivatedEventArgs - 通过“联系人选取器”激活应用程序时的事件参数 * ContactPickerUI - 获取 ContactPickerUI 对象 * PreviousExecutionState, Kind, SplashScreen - 各种激活 app 的方式的事件参数基本上都有这些属性，就不多说了 ** ContactPickerUI - 自定义联系人选取器的帮助类 * SelectionMode - 获取由 ContactPicker（调用者）设置的 SelectionMode 属性 * DesiredFields - 获取由 ContactPicker（调用者）设置的 DesiredFields 属性 * AddContact（string id, Contact contact） - 选取一个联系人 * id - 联系人标识 * contact - 一个 Contact 对象 * RemoveContact（） - 删除指定标识的联系人 * ContainsContact（） - 指定标识的联系人是否已被选取 * ContactRemoved - 移除一个已被选取的联系人时所触发的事件 ** Contact - 返回给调用者的联系人对象 * Name - 名称 * Thumbnail - 缩略图 * Fields - 联系人的字段数据，每一条数据都是一个实现了 IContactField 接口的对象 ** ContactField - 实现了 IContactField 接口，用于描述联系人的某一个字段数据 * Type - 字段类型（ContactFieldType 枚举） * Email, PhoneNumber, Location, InstantMessage, Custom * Category - 字段类别（ContactFieldCategory 枚举） * None, Home, Work, Mobile, Other * Value - 字段的值 */using System;using Windows.ApplicationModel.Activation;using Windows.ApplicationModel.Contacts.Provider;using Windows.UI.Xaml;using Windows.UI.Xaml.Controls;using Windows.UI.Xaml.Navigation;using Windows.ApplicationModel.Contacts;using Windows.Storage.Streams;using Windows.UI.Core;namespace XamlDemo.Picker{public sealed partial class MyContactPicker : Page{private ContactPickerUI _contactPickerUI;public MyContactPicker（）{this.InitializeComponent（）;}protected override void OnNavigatedTo（NavigationEventArgs e）{// 获取 ContactPickerUI 对象var contactPickerActivated = e.Parameter as ContactPickerActivatedEventArgs;_contactPickerUI = contactPickerActivated.ContactPickerUI;_contactPickerUI.ContactRemoved += _contactPickerUI_ContactRemoved; }protected override void OnNavigatedFrom（NavigationEventArgs e）{_contactPickerUI.ContactRemoved -= _contactPickerUI_ContactRemoved;}// 从选取缓冲区移除后async void _contactPickerUI_ContactRemoved（ContactPickerUI sender, ContactRemovedEventArgs args）{// 注意：无法直接得知 ContactPickerUI 是单选模式还是多选模式，需要判断当添加了一个联系人后，再添加一个联系人，如果系统会自动移除前一个联系人，则说明是单选模式await this.Dispatcher.RunAsync（CoreDispatcherPriority.Normal, （） =>{lblMsg.Text += "removed contact: " + args.Id;lblMsg.Text += Environment.NewLine;}）;}private void btnAddContract_Click（object sender, RoutedEventArgs e）{Random random = new Random（）;// 构造一个 Contact 对象Contact contact = new Contact（）;contact.Name = "webabcd " + random.Next（1000, 10000）.ToString（）;contact.Fields.Add（new ContactField（random.Next（1000, 10000）.ToString（）, ContactFieldType.Email, ContactFieldCategory.Home））;contact.Fields.Add（new ContactField（random.Next（1000, 10000）.ToString（）, ContactFieldType.Email, ContactFieldCategory.Work））;contact.Fields.Add（new ContactField（random.Next（1000, 10000）.ToString（）, ContactFieldType.PhoneNumber, ContactFieldCategory.Home））;contact.Fields.Add（new ContactField（random.Next（1000, 10000）.ToString（）, ContactFieldType.PhoneNumber, ContactFieldCategory.Work））;contact.Thumbnail = RandomAccessStreamReference.CreateFromUri（new Uri（"ms-appx:///Assets/Logo.png", UriKind.Absolute））;string id = Guid.NewGuid（）.ToString（）;// 向选取缓冲区新增一个联系人switch （_contactPickerUI.AddContact（id, contact））{case AddContactResult.Added: // 已被成功添加lblMsg.Text += "added contact: " + id;lblMsg.Text += Environment.NewLine;break;case AddContactResult.AlreadyAdded: // 选取缓冲区已有此联系人lblMsg.Text += "already added contact: " + id;lblMsg.Text += Environment.NewLine;break;case AddContactResult.Unavailable: // 无效联系人lblMsg.Text += "unavailable contact: " + id;lblMsg.Text += Environment.NewLine;break;}}}}

2、判断程序是否是由联系人选取器激活，在 App.xaml.cs 中 override void OnActivated （IActivatedEventArgs args）
App.xaml.cs

protected override void OnActivated（IActivatedEventArgs args）{// 通过联系人选取器激活应用程序时if （args.Kind == ActivationKind.ContactPicker）{ContactPickerActivatedEventArgs contactPickerArgs = args as ContactPickerActivatedEventArgs;Frame rootFrame = new Frame（）;rootFrame.Navigate（typeof（MainPage）, contactPickerArgs）;Window.Current.Content = rootFrame;Window.Current.Activate（）;}}