选择器
在Windows Phone中,除了启动器之外,还有很多,类似于保存电话号码,选择好友等一系列的功能,它们被称为选择器。
选择器和启动器的区别:启动器在启动这些功能的时候,并没有强行要求运行完成后立即返回到你正在开发的应用程序中,也就是说没有一个明确的返回值返回到你的应用程序中。而选择器则不同,如果我们启动了一个相机应用程序,那么很明显用户在拍照之后,我们的应用程序应该会去处理这张照片,是该保存还是该放弃等。
这些选择器的一个共同的使用格式是,都有一个Show方法和一个Completed事件,使用Show方法来显示供用户选择的界面,使用Complete监听并处理用户完成操作之后的细节。
Windows Phone中的选择器:
- CameraCaptureTask
- EmailAddressChooserTask
- PhotoChooserTask
- SaveContactTask
- PhoneNumberChooserTask
- AddressChooserTask
- GameInviteTask
- SaveEmailAddressTask
- SavePhoneNumberTask
- SaveRingtoneTask
CameraCaptureTask
CameraCaptureTask 通过相机拍摄任务,用户能够从您的应用程序中使用内置“相机”应用程序拍摄照片。如果用户完成此任务,将会引发一个事件,并且事件处理程序将会在结果中收到一张照片。
注意:
从 Windows Phone OS 7.1 开始,我们便可以直接在自己的应用程序中使用设备相机。
通过调用 CameraCaptureTask 对象的 Show 方法启动“相机”应用程序。通过处理 Completed 事件获取选择器操作的结果。
使用方式:
CameraCaptureTask myCameraCaptureTask;//创建照相任务实例 //拍照 myCameraCaptureTask = new CameraCaptureTask();//实例化 myCameraCaptureTask.Completed += new EventHandler<PhotoResult>(myCameraCaptureTask_Completed);//增添事件处理 try { myCameraCaptureTask.Show();//显示应用程序 } catch (System.InvalidOperationException ex) { MessageBox.Show(ex.Message); }
完成事件:
//拍照完成 void myCameraCaptureTask_Completed(object sender, PhotoResult e) { if (e.TaskResult == TaskResult.OK)//拍照完成 { MessageBox.Show(e.ChosenPhoto.Length.ToString()); } }
EmailAddressChooserTask
EmailAddressChooserTask使用电子邮件地址选择器任务可获取用户选择的联系人的电子邮件地址。此任务启动“联系人”应用程序,以便用户能够选择联系人。如果用户完成此任务,将会引发一个事件,并且事件处理程序将会在结果中收到一个地址。
使用方式:
EmailAddressChooserTask myEmailAddressChooserTask;//创建邮件地址选择任务实例 //邮件地址 myEmailAddressChooserTask = new EmailAddressChooserTask(); myEmailAddressChooserTask.Completed += new EventHandler<EmailResult>(myEmailAddressChooserTask_Completed); try { myEmailAddressChooserTask.Show();//显示邮件地址选择 } catch (System.InvalidOperationException ex) { MessageBox.Show(ex.Message); }
完成事件:
//邮件地址选择完成 void myEmailAddressChooserTask_Completed(object sender, EmailResult e) { if (e.TaskResult == TaskResult.OK)//选择完成 { MessageBox.Show("The email for " + e.DisplayName + " is " + e.Email); } }
PhotoChooserTask
使用照片选择器任务使用户能够从电话中选择现有照片。此任务可以启动照片选择器应用程序。如果用户完成此任务,将会引发一个事件,并且事件处理程序将会在结果中收到一张照片。
属性:
- PixelHeight获取或设置在照片选择过程中由用户设置的裁剪区域纵横比的最大高度和高度组件。
- PixelWidth获取或设置在照片选择过程中由用户设置的裁剪区域纵横比的最大高度和高度组件。
- ShowCamera获取或设置在照片选择过程中是否向用户显示用于启动相机的按钮。
使用方式:
PhotoChooserTask myPhotoChooserTask;//创建照片选择任务实例 //照片选择 myPhotoChooserTask = new PhotoChooserTask(); myPhotoChooserTask.Completed += new EventHandler<PhotoResult>(myPhotoChooserTask_Completed); try { myPhotoChooserTask.Show(); } catch (System.InvalidOperationException ex) { MessageBox.Show(ex.Message); }
完成事件:
//照片选择完成 void myPhotoChooserTask_Completed(object sender, PhotoResult e) { if (e.TaskResult == TaskResult.OK) { MessageBox.Show(e.ChosenPhoto.Length.ToString());//在这里关于照片的事件,完全可以使用{Bitmap myBitmap=new Bitmap();myBitmap.SetSource(e.ChosenPhoto);}使用照片 } }
SaveContactTask
使用保存联系人任务可使用户能够通过您的应用程序保存联系人。此任务启动“联系人”应用程序。
属性:
- FirstName获取或设置联系人的名字。
- LastName获取或设置联系人的姓氏。
- MiddleName获取或设置联系人的中名。
- Title获取或设置联系人名字的别称。
- WorkPhone获取或设置与联系人关联的工作电话号码。
- WorkEmail获取或设置与联系人关联的工作电子邮件地址。
- MobilePhone获取或设置与联系人关联的移动电话号码。
使用方式:
SaveContactTask mySaveContactTask;//创建保存联系人任务实例 //保存联系人 mySaveContactTask=new SaveContactTask (); mySaveContactTask.Completed += new EventHandler<SaveContactResult>(mySaveContactTask_Completed); try { mySaveContactTask.FirstName = "丽"; mySaveContactTask.LastName = "李"; mySaveContactTask.MobilePhone = "1101101101"; mySaveContactTask.Show(); } catch (System.InvalidOperationException ex) { MessageBox.Show(ex.Message); }
完成事件:
//保存联系人任务完成 void mySaveContactTask_Completed(object sender, SaveContactResult e) { switch (e.TaskResult) { case TaskResult.OK: MessageBox.Show("Contact saved."); break; case TaskResult.Cancel: MessageBox.Show("Save cancelled."); break; case TaskResult.None: MessageBox.Show("Contact could not be saved."); break; } }
PhoneNumberChooserTask
使用电话号码选择器任务可获取用户选择的联系人的电话号码。此任务启动“联系人”应用程序,以便用户能够选择联系人。如果用户完成此任务,将会引发一个事件,并且事件处理程序将会在结果中收到一个电话号码。
使用方式:
PhoneNumberChooserTask myPhoneNumberChooserTask;//创建电话号码选择器实例 //电话号码选择器 myPhoneNumberChooserTask = new PhoneNumberChooserTask(); myPhoneNumberChooserTask.Completed += new EventHandler<PhoneNumberResult>(myPhoneNumberChooserTask_Completed); try { myPhoneNumberChooserTask.Show(); } catch (System.InvalidOperationException ex) { MessageBox.Show(ex.Message); }
完成事件:
//电话号码选择完毕 void myPhoneNumberChooserTask_Completed(object sender, PhoneNumberResult e) { if (e.TaskResult == TaskResult.OK) { MessageBox.Show("The phone number for " + e.DisplayName + " is " + e.PhoneNumber); } }
AddressChooserTask
使用地址选择器任务可获取用户选择的联系人的物理地址。此任务启动“联系人”应用程序,以便用户能够选择联系人。如果用户完成此任务,将会引发一个事件,并且事件处理程序将会在结果中收到一个地址。
使用方式:
AddressChooserTask myAddressChooserTask;//创建地址选择实例 //地址选择 myAddressChooserTask = new AddressChooserTask(); myAddressChooserTask.Completed += new EventHandler<AddressResult>(myAddressChooserTask_Completed); try { myAddressChooserTask.Show(); } catch (System.InvalidOperationException ex) { MessageBox.Show(ex.Message); }
完成事件:
//地址选择完成 void myAddressChooserTask_Completed(object sender, AddressResult e) { if (e.TaskResult == TaskResult.OK) { MessageBox.Show("The address for " + e.DisplayName + " is " + e.Address); } }
GameInviteTask
使用游戏邀请任务可以显示游戏邀请屏幕,该屏幕允许用户邀请多个玩家加入一个多人游戏会话。邀请是异步发送的。
注意:仅当从游戏中调用,且该游戏经批准可在 Windows Phone 上的 Xbox LIVE 中发布时,游戏邀请任务才有效。
属性:
- SessionId获取或设置标识网络会话的字符串。
使用方式:
GameInviteTask myGameInviteTask;//创建游戏邀请实例 //游戏邀请 myGameInviteTask = new GameInviteTask(); myGameInviteTask.Completed += new EventHandler<TaskEventArgs>(myGameInviteTask_Completed); try { myGameInviteTask.SessionId = "my session id";//不能执行啊,没有实际的id myGameInviteTask.Show(); } catch (System.InvalidOperationException ex) { MessageBox.Show(ex.Message); }
完成事件:
//游戏邀请完成 void myGameInviteTask_Completed(object sender, TaskEventArgs e) { switch (e.TaskResult) { case TaskResult.OK: MessageBox.Show("Game invitation sent."); break; case TaskResult.Cancel: MessageBox.Show("Game invitation cancelled."); break; case TaskResult.None: MessageBox.Show("Game invitation could not be sent."); break; } }
SaveEmailAddressTask
使用保存电子邮件地址任务可使用户能够通过您的应用程序保存电子邮件地址。此任务启动“联系人”应用程序。
属性:
- Email获取或设置可以保存到联系人的电子邮件地址。
使用方式:
SaveEmailAddressTask mySaveEmailAddressTask;//创建保存邮件地址实例 //邮件地址保存 mySaveEmailAddressTask = new SaveEmailAddressTask(); mySaveEmailAddressTask.Completed += new EventHandler<TaskEventArgs>(mySaveEmailAddressTask_Completed); try { mySaveEmailAddressTask.Email = "33333@qq.com"; mySaveEmailAddressTask.Show(); } catch (System.InvalidOperationException ex) { MessageBox.Show(ex.Message); }
完成事件:
//保存邮件地址完成 void mySaveEmailAddressTask_Completed(object sender, TaskEventArgs e) { switch (e.TaskResult) { case TaskResult.OK: MessageBox.Show("Email saved."); break; case TaskResult.Cancel: MessageBox.Show("Save cancelled."); break; case TaskResult.None: MessageBox.Show("Email could not be saved."); break; } }
SavePhoneNumberTask
使用保存电话号码任务可使用户能够通过您的应用程序保存电话号码。此任务启动“联系人”应用程序。
属性:
- PhoneNumber获取或设置可以保存到联系人的电话号码。
使用方式:
SavePhoneNumberTask mySavePhoneNumberTask;//创建保存联系电话实例 //保存联系电话 mySavePhoneNumberTask = new SavePhoneNumberTask(); mySavePhoneNumberTask.Completed += new EventHandler<TaskEventArgs>(mySavePhoneNumberTask_Completed); try { mySavePhoneNumberTask.PhoneNumber = "111111111"; mySavePhoneNumberTask.Show(); } catch (System.InvalidOperationException ex) { MessageBox.Show(ex.Message); }
完成事件:
//保存联系电话 void mySavePhoneNumberTask_Completed(object sender, TaskEventArgs e) { switch (e.TaskResult) { case TaskResult.OK: MessageBox.Show("Phone number saved."); break; case TaskResult.Cancel: MessageBox.Show("Save cancelled."); break; case TaskResult.None: MessageBox.Show("Phone number could not be saved."); break; } }
SaveRingtoneTask
使用保存铃声任务,用户可以将音频文件保存到系统铃声列表中。此任务会启动“铃声”应用程序,其中用户可以保存铃声而且可以选择将其设置为默认铃声。将音频文件添加到该列表后,用户就可以在“联系人”应用程序中将其设置为各个联系人的铃声。
铃声音频文件必须满足以下要求:
- 文件类型必须为 MP3 或 WMA。
- 文件大小必须小于 1 MB。
- 文件播放的时长必须小于 40 秒。
- 文件不得具有数字版权管理 (DRM) 保护。
属性:
- DisplayName用于在选取器中标识铃声的名称。
- IsShareable指示其他应用程序是否可以访问此铃声的标志。
- Source要添加到铃声目录的音频文件本地副本的文件路径。
使用方式:
SaveRingtoneTask mySaveRingToneTask;//创建保存铃声实例 //保存铃声 mySaveRingToneTask = new SaveRingtoneTask(); mySaveRingToneTask.Completed += new EventHandler<TaskEventArgs>(mySaveRingToneTask_Completed); try { mySaveRingToneTask.Source = new Uri("test.wma"); mySaveRingToneTask.DisplayName = "my name"; mySaveRingToneTask.Show(); } catch (System.InvalidOperationException ex) { MessageBox.Show(ex.Message); }
完成事件:
//保存铃声 void mySaveRingToneTask_Completed(object sender, TaskEventArgs e) { switch (e.TaskResult) { case TaskResult.OK: MessageBox.Show("Ringtone saved."); break; case TaskResult.Cancel: MessageBox.Show("Save cancelled."); break; case TaskResult.None: MessageBox.Show("Ringtone could not be saved."); break; } }