如何选择加入 Toast 通知（Windows 运行时应用）

项目
12/11/2015

[ 本文适用于编写 Windows 运行时应用的 Windows 8.x 和 Windows Phone 8.x 开发人员。如果你要针对 Windows 10 进行开发，请参阅最新文档 ]

注意不使用 JavaScript？请参阅如何选择接受 Toast 通知 (XAML)。

本主题介绍如何指定应用能够引发 Toast 通知。

你需要了解的内容

技术

Windows Runtime

先决条件

要理解本主题，你需要：

了解 Toast 通知术语及概念。有关详细信息，请参阅 Toast 概述。
熟悉 Toast XML 架构，基本熟悉 XML 及其通过文档对象模型 (DOM) API 的操作。有关详细信息，请参阅 Toast 架构。

说明

步骤 1: 声明 Toast 通知功能

引发 Toast 通知的能力在应用的 package.appxmanifest 清单文件中进行声明。如果使用 Microsoft Visual Studio 清单编辑器，则仅需在“应用程序”选项卡的“通知”****部分中将“支持 Toast”选项设置为“是”。

以下示例介绍作为选择此选项的结果插入到 package.appxmanifest 文件中的 XML。ToastCapable 特性添加到清单的 VisualElements 元素。

此示例还显示了在 Visual Studio 外部手动创建 package.appxmanifest 文件时要添加的内容。有关详细信息，请参阅如何手动创建包清单。请注意，尽管 Visual Studio 选项为“是”，但写入 package.appxmanifest 文件的是“true”。


<VisualElements 
    ...
    ToastCapable="true">
</VisualElements>

步骤 2: 声明 Toast 通知的背景色和文本颜色（仅限 Windows）

你可以为 Toast 通知声明背景颜色和浅色或深色文本。请注意，此设置也适用于始终链接的磁贴—Toast 和磁贴通知背景以及文本颜色。

如果使用 Visual Studio 清单编辑器，则在“可见资产”选项卡中选择“前台文本”****选项。将“背景颜色”选项设置为 W3DC 颜色字符串（例如“#FFFFFF”）。

注意 Windows Phone 应用商店应用不允许你设置文本或背景颜色。Toast 的背景颜色是系统主题色，用户可以在“设置”中选择此颜色，而文本将始终显示为浅色。

以下示例介绍作为选择这些选项的结果插入到 package.appxmanifest 文件中的 XML。ForegroundText 和 BackgroundColor 特性已添加到清单的 VisualElements 元素。


<VisualElements 
    ...
    ForegroundText="dark" 
    BackgroundColor="#FFFFFF">
</VisualElements>

步骤 3: 指定徽标图像

应用的小徽标图像显示在每个 Toast 通知的右下角，用于让用户识别引发通知的应用。

注意 Windows Phone 8.1 不使用此徽标图像。磁贴仅显示应用的显示名称（如清单中所述）或者不显示任何内容。

如果使用 Visual Studio 清单编辑器，则在“可见资产”选项卡中设置“正方形 30x30 徽标”****(Windows) 或“正方形 44x44 徽标”(Windows Phone) 图像路径。指定的图像必须包含在应用包中。

以下示例介绍作为选择这些选项的结果插入到 package.appxmanifest 文件中的 XML。SmallLogo 特性添加到清单的 VisualElements 元素。


<VisualElements 
    ...
    SmallLogo="images\smallTile-sdk.png">
</VisualElements>

备注

完成上述步骤之后，你的应用便可以向用户发送 Toast 通知了。

完整示例

以下示例显示了 package.appxmanifest 文件中某个示例 Windows 应用的 VisualElements 元素的完整 XML，其中包括本主题中所述的属性。


<VisualElements 
    DisplayName="ToastsSample" 
    Logo="images\squareTile-sdk.png" 
    SmallLogo="images\smallTile-sdk.png" 
    Description="SDK Sample" 
    ForegroundText="dark" 
    BackgroundColor="#FFFFFF" 
    ToastCapable="true">
    <DefaultTile ShortName="ToastsSample" ShowName="allLogos"/>
    <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png"/>
</VisualElements>

通过