前面老周用了两篇烂文,向大家介绍了Adaptive磁贴的模板使用。那些XML模板已经很强大了,不过,如果你觉得那些排版还不足以满足需求,不妨试试自己来定义磁贴的内容。
其实,Runtime App支持在后台任务中生成XAML呈现,只要你编写的后台任务类从XamlRenderingBackgroundTask(位于Windows.UI.Xaml.Media.Imaging命名空间)类派生即可。利用这一特性,我们可以在后台生成XAML布局,然后通过RenderTargetBitmap类来呈现XAML内容,再把它保存为图片,最后把保存的图片作为磁贴的背景,就能达到自定义磁贴内容的功效了。
第一步,在主应用程序项目中,添加一个XAML文件,因为这个文件不参与编译,也没有对应的Code hide文件,就单个XAML文件即可,实际上是一个文本文件。因此,在生成操作上要设置为“内容”,是否复制到输出目录,选择“不复制”,自定义工具不用填。如图
然后你可以自己来设计排版,就和平时用XAML设计界面一样。
<Border
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
BorderThickness="0">
<Border.Background>
<ImageBrush AlignmentX="Center" AlignmentY="Center" Stretch="UniformToFill" ImageSource="Assets/1.jpg" />
</Border.Background>
</Border>
好了,我的界面就这样吧,简单好用。
第二步,向解决方案添加一个Windows运行时组件项目,用来在其中定义后台任务类。代码如下:
public sealed class UpdatetileTask : XamlRenderingBackgroundTask
{
protected override async void OnRun(IBackgroundTaskInstance taskInstance)
{
……
}
}
注意,这里和以前我们定义普通的后台任务不同,这一次不是实现后台任务接口,而是从XamlRenderingBackgroundTask类派生,然后重写OnRun方法。
里面的处理和一般的后台任务一样了。
1、先要从项目目录加载我们刚才自己定义的那个.xaml文件。
Border root = new Border();
Application.LoadComponent(root, new Uri("ms-appx:///customRender.xaml"));
root.Width = ;
root.Height = ;
LoadComponent是Application类的一个静态方法,直接调用即可,第一个参数是要生成的可视化对象的实例,第二个参数是XAML文件的URI。
我们声明的可视化对象的类型一定要与XAML文档中的根节点的类型匹配,上面在定义XAML文档时,根节点是Border,因此这里声明的变量类型必须为Border,LoadComponent方法调用后,会自动加载并编译XAML文档,然后填充Border变量。
为了让可视化对象能够呈现到位图中,记住要显示设置它的高度和宽度,因为默认情况下Width和Height都为0。
2、呈现XAML对象到位图。
// 将XAML对象呈现到图像中
RenderTargetBitmap rtb = new RenderTargetBitmap();
// 因为示例是为宽磁贴生成背景图片的
// 所以目标的图像大小与宽磁贴相同即可
// 310 x 150
await rtb.RenderAsync(root, , );
// 取出图像数据
IBuffer bfData = await rtb.GetPixelsAsync();
// 将其转换为字节数组
byte[] data = bfData.ToArray();
3、在本地目录中创建新的PNG文件,并把呈现的XAML内容编码到图像文件中。
// 在本地目录中创建新的PNG图像文件
StorageFolder localfd = ApplicationData.Current.LocalFolder;
StorageFile pngFile = await localfd.CreateFileAsync("bg.png", CreationCollisionOption.ReplaceExisting);
// 打开文件流
using (IRandomAccessStream stream = (await pngFile.OpenAsync(FileAccessMode.ReadWrite)))
{
// 创建PNG图像编码器
BitmapEncoder encoder = await BitmapEncoder.CreateAsync(BitmapEncoder.PngEncoderId, stream);
// 设置图像数据
encoder.SetPixelData(BitmapPixelFormat.Bgra8, BitmapAlphaMode.Straight, (uint)rtb.PixelWidth, (uint)rtb.PixelHeight, 72d, 72d, data);
await encoder.FlushAsync();
}
4、文件保存后,可以用ms-appdata:///local/开头的URI来访问文件。这时候,我们可以生成磁贴通知的XML文档,并更新磁贴。
// 组创XML文档
string xml = "<tile>" +
"<visual>" +
"<binding template=\"TileWide\">" +
"<image src=\"ms-appdata:///local/bg.png\" placement=\"background\" />" +
"</binding>" +
"</visual>" +
"</tile>";
// 创建XML文档
XmlDocument doc = new XmlDocument();
doc.LoadXml(xml);
// 更新磁贴通知
TileNotification notification = new TileNotification(doc);
TileUpdater updater = TileUpdateManager.CreateTileUpdaterForApplication();
updater.Update(notification);
第三步,在主应用程序中引用刚才的后台任务项目。然后配置一下清单文件,在正式版的SDK中,已经可以使用图形化的清单编辑器了,可以直接操作。
添加一个后台任务声明,类型为“常规”。
填上后台任务类的入口点,即类名,要包括命名空间的名字。
第四步,在前台代码中注册后台任务。前面的文章中,老周给大家介绍过可以通ApplicationTrigger直接在应用程序中触发后台任务,所以本示例我就用它了。
var res = await BackgroundExecutionManager.RequestAccessAsync();
if (res == BackgroundAccessStatus.Denied || res == BackgroundAccessStatus.Unspecified)
{
Debug.WriteLine("后台任务被禁用。"); return;
} // 考虑注册后台任务
BackgroundTaskRegistration reg = BackgroundTaskRegistration.AllTasks.Values.FirstOrDefault(t => t.Name == TASK_NAME) as BackgroundTaskRegistration; if (reg == null)
{
BackgroundTaskBuilder bd = new BackgroundTaskBuilder();
bd.Name = TASK_NAME;
bd.TaskEntryPoint = typeof(backUpdater.UpdatetileTask).FullName;
ApplicationTrigger trigger = new ApplicationTrigger();
bd.SetTrigger(trigger);
reg = bd.Register();
}
最后,我们可以在代码中手动触发这个后台。
BackgroundTaskRegistration reg = BackgroundTaskRegistration.AllTasks.Values.FirstOrDefault(t => t.Name == TASK_NAME) as BackgroundTaskRegistration;
if (reg == null)
{
return;
} ApplicationTrigger trigger = reg.Trigger as ApplicationTrigger;
await trigger.RequestAsync();
运行应用程序后,把程序固定到开始屏幕,并把图标改为宽磁贴,然后回到应用程序,触发后台,更新磁贴。
唉,天天写代码很枯燥,很无聊?没事,一起来坐在桃花底下读读《西厢记》,就会好的了。
OK,今天的牛皮暂时吹到这里。
例子源代码下载:http://files.cnblogs.com/files/tcjiaan/customTileUpdateApp.zip