UWP 磁贴设置

一：需求

一款好看好用的应用，对于UWP来说，动态的磁贴必不可少。

二：TileUpdateManager类 和TileUpdater类

如果需要更改或更新应用的磁贴，那么首先需要获得TileUpdater对象，顾名思义，TileUpdater就是磁贴的更新器。

通过TileUpdateManager类得到TileUpdater对象

TileUpdater tileUpdater = TileUpdateManager.CreateTileUpdaterForApplication();

三：TileUpdater 磁贴更新器类

3.1 清空应用的磁贴 

TileUpdater 有一个clear()方法用于清空当前应用的磁贴的内容，恢复为默认模式，默认就是一个软件的logo。该方法可以用于软件内点击按钮关闭动态磁贴的功能。

//删除所有更新并将平铺导致以显示其默认内容（如应用程序清单所声明）。
public void Clear();

tileUpdater.Clear();

　3.2  更新磁贴

　TileUpdater 有一个Update() 方法，用于更新磁贴，可以说是比较关键的方法了。先来看看方法的定义。

// 将内容或外观的更改应用于图块。
// notification:
// 为平铺的内容提供新的 XML 定义的对象。
public void Update(TileNotification notification);

参数需要提供一个 TileNotification 对象。查看TileNotification类的构造函数可以发现

public TileNotification(XmlDocument content);

TileNotification类的构造函数需要传递进一个XmlDocument对象。

实际上磁贴的模板就是一个xml的文件。TileNotification 对象就是用来放要更新的磁贴的模板。

四：磁铁模板

磁贴的模板可以用微软预定的磁贴模板，或者自己定义模板。

　4.1获取微软预设的磁贴模板

XmlDocument xml = TileUpdateManager.GetTemplateContent(TileTemplateType.TileSquare150x150Block);

TileTemplateType里有很多微软预设的磁贴的模板，主要是根据不同的磁贴大小，微软自己预设的磁贴。

4.2 创建自适应磁贴模板
自适应磁贴是win10一项新的功能，允许我们针对不同的磁贴大小设定模板。

既然磁贴的模板是xml格式的，那么它就是标记性语言。你可以像xaml那样，或者用类的方式定义。
请安装名为 Microsoft.Toolkit.Uwp.Notifications 的 NuGet 程序包（搜索“notifications uwp”）

xml格式：

<tile>
  <visual>

    <binding template="TileSmall">
      <text>Small</text>
    </binding>

    <binding template="TileMedium">
      <text>Medium</text>
    </binding>

    <binding template="TileWide">
      <text>Wide</text>
    </binding>

    <binding template="TileLarge">
      <text>Large</text>
    </binding>

  </visual>
</tile>

c#格式

TileContent content = new TileContent()
{
    Visual = new TileVisual()
    {
        TileSmall = new TileBinding()
        {
            Content = new TileBindingContentAdaptive()
            {
                Children =
                {
                    new AdaptiveText() { Text = "Small" }
                }
            }
        },

        TileMedium = new TileBinding()
        {
            Content = new TileBindingContentAdaptive()
            {
                Children =
                {
                    new AdaptiveText() { Text = "Medium" }
                }
            }
        },

        TileWide = new TileBinding()
        {
            Content = new TileBindingContentAdaptive()
            {
                Children =
                {
                    new AdaptiveText() { Text = "Wide" }
                }
            }
        },

        TileLarge = new TileBinding()
        {
            Content = new TileBindingContentAdaptive()
            {
                Children =
                {
                    new AdaptiveText() { Text = "Large" }
                }
            }
        }
    }
};

这个自适应的磁贴也仅仅是针对四种状体的磁贴定义的。因为微软的磁贴也只能有（小，中，宽，大）四种形态。分别对应（TileSmall，TileMedium ，TileWide，TileLarge）。在每种状态里，添加你需要内容即可。你可以添加PeekImage，BackgroundImage，AdaptiveText等。

如果你用的是c#写的磁贴模板，有一个TileContent.Getxml() 方法用于将c#代码转化成xml。

这样你再创建一个TileNotification对象，通过TileUpdater.update()就可以更新磁贴了。

var xmlDocument= content.GetXml();

TileNotification tileNotification = new TileNotification(xmlDocument);
TileUpdater tileUpdater = TileUpdateManager.CreateTileUpdaterForApplication();
tileUpdater.Update(tileNotification);

微软开发者文档地址：https://docs.microsoft.com/zh-cn/windows/uwp/controls-and-patterns/tiles-and-notifications-create-adaptive-tiles

-------some words-------

1.Notification 通知

2..tile 磁贴

---------the  end----------