3. 提供磁贴详细信息 如果还未打开，请选择清单编辑器的“应用程序 UI”窗格。

使用你自己的徽标图像的路径取代默认的图像。

选择是否在磁贴上显示应用的短名称。此名称不能超过 13 个字符。如果名称太长，将会被截断。你可以选择显示徽标，显示名称或两者都不显示。

选择名称的文本是使用浅色字体还是深色字体（基于背景色）。

接受默认背景色，或以 W3DC 颜色字符串（如“#FFFFFF”）提供自己的颜色。此背景色用于对应用的其他部分进行着色：任意应用中对话框的按钮颜色，以及 Windows 应用商店中的“应用详情”页。

若要使用已安装的模板在 Visual Studio Express 2012 RC for Windows 8 中创建新项目，则需在包清单中定义默认的磁贴及其图像。

先决条件　Visual Studio Express 2012 RC for Windows 8

显示在磁贴上的图像文件，150 x 150 像素。

该图像文件的较小版本，30 x 30 像素。此图像不用于磁贴本身，而是在搜索结果、“所有程序”列表以及 UI 的其他位置中使用。

推荐：该图像文件的加宽版本为 310 x 150 像素。 注意 如果未提供加宽图像，则除非发布你的应用的新版本，否则无法通过加宽模板更新磁贴。但是，磁贴显示为正方形磁贴还是加宽磁贴由用户决定。有关何时应该包括以及何时不应包括加宽图像的详细信息，请参阅磁贴指南和清单。

本主题假设你了解磁贴和通知术语及概念，以及 XML。还假设你知道如何使用 Windows 运行时 API 创建采用 JavaScript 的基本的 Modern 风格应用。

若要使此页上显示的示例代码正常工作，则必须在文件中包含以下行：

为磁贴选择一个模板并获取它的 XML 内容 var tileXml = Notifications.TileUpdateManager.getTemplateContent(Notifications.TileTemplateType.tileWideText03);

有关完整的模板列表，请参阅 TileTemplateType。

通过文档对象模型 (DOM) 方法提供模板内容 此示例使用 TileWideText03 模板，该模板包含一个可包含三行自动换行的文本字符串，如下所示：

基于已经指定的 XML 内容创建通知

var tileNotification = new Notifications.TileNotification(tileXml);

为通知设置到期时间 该通知将在十分钟内到期并从磁贴中删除。

向应用磁贴发送通知。

贴

先决条件

了解磁贴和通知术语及概念。有关详细信息，请参阅磁贴、锁屏提醒以及通知。

使用 Windows 运行时 API 创建采用 JavaScript 的基本 Modern 风格应用的功能。

若要使此页上显示的示例代码正常工作，则必须在文件中包含以下行：

步骤 1: 定义加宽磁贴 此示例选择模板，检索模板文本和图像元素，以及为这些元素分配值。

步骤 2: 定义正方形磁贴 此示例重复执行仅图像正方形磁贴的前面步骤。

步骤 3: 向宽磁贴的负载添加正方形磁贴 此示例检索 binding 元素，该元素定义 squareTileXml 负载中的正方形磁贴并导入该元素以及将其作为加宽磁贴的同级追加。

appendChild(node);

前面的步骤在 XML 负载的一个 visual 元素下添加了两个 binding 元素，结果如下所示：

说明

步骤 1: 设置选项以启用通知循环 此代码为你的应用启用通知队列。运行应用时，仅需要发起此调用一次，因此应在初始化代码中发起此次调用。

步骤 2: 创建磁贴通知 这是所有磁贴通知中的第一步且这种情形与其他任何情形没有区别，此处包含该步骤仅用于完整性。有关详细信息，请参阅快速入门：发送磁贴更新。

var template = Windows.UI.Notifications.TileTemplateType.tileWideText03; var tileXml = Windows.UI.Notifications.TileUpdateManager.getTemplateContent(template); // TODO: Fill in the template with your tile content.// TODO: Define a square tile and add it to tileXML.var tileNotification = new Windows.UI.Notifications.TileNotification(tileXml);

步骤 3: 授予通知标记 此步骤可选。标记为不超过 16 个字符的字符串加上终止 NULL 字符，用于唯一标识应用中的通知。

步骤 4: 向磁贴发送通知

步骤 1: 清除通知并还原为默认磁贴。 此行代码从应用的磁贴中清除当前通知。

对于启用通知队列且在队列中有通知的磁贴，调用 clear 方法清空队列。

请注意，不能通过云清除通知。尽管本地调用 clear 方法都会清除磁贴而不要加快通知的来源，但是，为了通过定期或推送通知清除磁贴中的通知，你应该发送一个新通知以替换当前内容。