背水一战 Windows 10 (96) - 选取器: ContactPicker

[源码下载]

作者：webabcd


介绍
背水一战 Windows 10 之 选取器

• ContactPicker（联系人选取窗口）
• 通过 ContactPicker 选取联系人，并获取其完整信息

示例
1、演示如何通过 ContactPicker 选择一个或多个联系人
Picker/ContactPickerDemo.xaml

<Page
x:Class="Windows10.Picker.ContactPickerDemo"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="using:Windows10.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="10 0 10 10">

<TextBlock Name="lblMsg" Margin="5" />

<Button Name="btnPickContact" Content="pick a contact" Click="btnPickContact_Click" Margin="5" />

<Button Name="btnPickContacts" Content="pick multiple contacts" Click="btnPickContacts_Click" Margin="5" />

</StackPanel>
</Grid>
</Page>

Picker/ContactPickerDemo.xaml.cs

/* 演示如何通过 ContactPicker 选择一个或多个联系人
*
* ContactPicker - 联系人选择窗口（有好多 api 在 uwp 中废弃了）
*     DesiredFieldsWithContactFieldType - 需要获取的联系人的字段（可以添加 ContactFieldType 类型的枚举）
*     PickContactAsync() - 弹出联系人选取器（只能选取一个），返回 Contact 类型的对象
*     PickContactsAsync() - 弹出联系人选取器（可以选取多个），返回 Contact 类型的对象
*
* Contact - 联系人对象
*     有一堆属性，看文档吧
*/

using System;
using System.Collections.Generic;
using Windows.ApplicationModel.Contacts;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;

namespace Windows10.Picker
{
public sealed partial class ContactPickerDemo : Page
{
public ContactPickerDemo()
{
this.InitializeComponent();
}

private async void btnPickContact_Click(object sender, RoutedEventArgs e)
{
ContactPicker contactPicker = new ContactPicker();
// 指定需要选取的联系人的字段
contactPicker.DesiredFieldsWithContactFieldType.Add(ContactFieldType.Email);
contactPicker.DesiredFieldsWithContactFieldType.Add(ContactFieldType.PhoneNumber);

// 启动联系人选取器，以选择一个联系人
Contact contact = await contactPicker.PickContactAsync();

if (contact != null)
{
lblMsg.Text += string.Format("name:{0}", contact.Name);
lblMsg.Text += Environment.NewLine;

foreach (ContactEmail email in contact.Emails)
{
lblMsg.Text += string.Format("email kind:{0}, email address:{1}", email.Kind, email.Address);
lblMsg.Text += Environment.NewLine;
}

foreach (ContactPhone phone in contact.Phones)
{
lblMsg.Text += string.Format("phone kind:{0}, phone number:{1}, phone description:{2}", phone.Kind, phone.Number, phone.Description);
lblMsg.Text += Environment.NewLine;
}
}
else
{
lblMsg.Text += "取消了";
lblMsg.Text += Environment.NewLine;
}
}

private async void btnPickContacts_Click(object sender, RoutedEventArgs e)
{
ContactPicker contactPicker = new ContactPicker();
// 指定需要选取的联系人的字段
contactPicker.DesiredFieldsWithContactFieldType.Add(ContactFieldType.Email);
contactPicker.DesiredFieldsWithContactFieldType.Add(ContactFieldType.PhoneNumber);

// 启动联系人选取器，以选择多个联系人
IList<Contact> contacts = await contactPicker.PickContactsAsync();

if (contacts != null && contacts.Count > 0)
{
foreach (Contact contact in contacts)
{
lblMsg.Text += string.Format("name:{0}", contact.Name);
lblMsg.Text += Environment.NewLine;

foreach (ContactEmail email in contact.Emails)
{
lblMsg.Text += string.Format("email kind:{0}, email address:{1}", email.Kind, email.Address);
lblMsg.Text += Environment.NewLine;
}

foreach (ContactPhone phone in contact.Phones)
{
lblMsg.Text += string.Format("phone kind:{0}, phone number:{1}, phone description:{2}", phone.Kind, phone.Number, phone.Description);
lblMsg.Text += Environment.NewLine;
}
}
}
else
{
lblMsg.Text += "取消了";
lblMsg.Text += Environment.NewLine;
}
}
}
}

2、演示如何通过 ContactPicker 选取联系人，并获取其完整信息
Picker/ContactPicker2.xaml

<Page
x:Class="Windows10.Picker.ContactPicker2"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="using:Windows10.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="10 0 10 10">

<TextBlock Name="lblMsg" Margin="5" />

<Image Name="imgThumbnail" Width="100" Height="100" HorizontalAlignment="Left" Margin="5"  />

<Button Name="btnPickContact" Content="pick a contact" Click="btnPickContact_Click" Margin="5" />

</StackPanel>
</Grid>
</Page>

Picker/ContactPicker2.xaml.cs

/* 演示如何通过 ContactPicker 选取联系人，并获取其完整信息
*
* ContactPicker - 联系人选择窗口（有好多 api 在 uwp 中废弃了）
*     DesiredFieldsWithContactFieldType - 需要获取的联系人的字段（可以添加 ContactFieldType 类型的枚举）
*     PickContactAsync() - 弹出联系人选取器（只能选取一个），返回 Contact 类型的对象
*     PickContactsAsync() - 弹出联系人选取器（可以选取多个），返回 Contact 类型的对象
*
* Contact - 联系人对象
*     有一堆属性，看文档吧
*
*
* 注：
* 1、通过 ContactPicker 选取的联系人，可以获取的信息有限，但是可以通过 ContactStore 获取联系人的完整信息
* 2、通过 ContactStore 是可以获取到全部联系人的完整信息的，这部分知识点以后再写
* 3、通过 ContactStore 获取数据的话，需要在 Package.appxmanifest 中配置 <Capability Name = "contacts" />
*/

using System;
using System.Collections.Generic;
using Windows.ApplicationModel.Contacts;
using Windows.Storage.Streams;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Media.Imaging;

namespace Windows10.Picker
{
public sealed partial class ContactPicker2 : Page
{
public ContactPicker2()
{
this.InitializeComponent();
}

private async void btnPickContact_Click(object sender, RoutedEventArgs e)
{
ContactPicker contactPicker = new ContactPicker();
// 指定需要选取的联系人的字段
contactPicker.DesiredFieldsWithContactFieldType.Add(ContactFieldType.Email);
contactPicker.DesiredFieldsWithContactFieldType.Add(ContactFieldType.PhoneNumber);

// 启动联系人选取器，以选择一个联系人
Contact contact = await contactPicker.PickContactAsync();

if (contact != null)
{
lblMsg.Text += string.Format("name:{0}", contact.Name);
lblMsg.Text += Environment.NewLine;
lblMsg.Text += string.Format("id:{0}", contact.Id);
lblMsg.Text += Environment.NewLine;

foreach (ContactEmail email in contact.Emails)
{
lblMsg.Text += string.Format("email kind:{0}, email address:{1}", email.Kind, email.Address);
lblMsg.Text += Environment.NewLine;
}

foreach (ContactPhone phone in contact.Phones)
{
lblMsg.Text += string.Format("phone kind:{0}, phone number:{1}, phone description:{2}", phone.Kind, phone.Number, phone.Description);
lblMsg.Text += Environment.NewLine;
}

ContactStore contactStore = await ContactManager.RequestStoreAsync(ContactStoreAccessType.AllContactsReadOnly);
// 通过 ContactStore 和联系人 id 可以获取到联系人的完整信息（需要配置 <Capability Name = "contacts" />）
Contact realContact = await contactStore.GetContactAsync(contact.Id);

// 通过 ContactStore 也是可以拿到全部联系人信息的，这部分知识点以后再写
// IReadOnlyList<Contact> contacts = await contactStore.FindContactsAsync();

// 显示联系人的图片（只通过 ContactPicker 是获取不到的）
IRandomAccessStreamReference imageStreamRef = realContact.SmallDisplayPicture;
if (imageStreamRef != null)
{
IRandomAccessStream imageStream = await imageStreamRef.OpenReadAsync();
BitmapImage bitmapImage = new BitmapImage();
bitmapImage.SetSource(imageStream);
imgThumbnail.Source = bitmapImage;
}
}
else
{
lblMsg.Text += "取消了";
lblMsg.Text += Environment.NewLine;
}
}
}
}

OK
[源码下载]