image (Toast XML 架构)

指定 Toast 模板中使用的图像。

元素层次结构

<吐 司>

<可视>

<binding>

<图像>

语法

<image id             = integer
       src            = string
       alt?           = string
       addImageQuery? = boolean 
       placement? = "appLogoOverride" | "hero"
       hint-crop? = "circle" />

密钥

? 可选 (零个或一个)

特性和元素

特性

属性	说明	数据类型	必须	默认值
addImageQuery	设置为“true”以允许 Windows 将查询字符串追加到 Toast 通知中提供的图像 URI。 如果你的服务器托管图像并且可以处理查询字符串，则可通过基于查询字符串搜索图像变量，或通过忽略查询字符串并且不带查询字符串按指定方式返回图像，来使用此特性。 此查询字符串指定比例、对比度设置和语言;例如，值为 “www.website.com/images/hello.png” 通知中的给定变为 “www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us”	boolean	否	false
alt	辅助技术用户的图像说明。	字符串	否	无
id	用于此映像的 Toast 模板中的 image 元素。 如果模板只有一个映像，则此值为 1。 可用图像位置的数量基于模板定义。	integer	是	无
src	使用以下协议处理程序之一的图像源的 URI： http:// 或 https:// 基于 Web 的图像。 ms-appx:/// 应用包中包含的图像。 ms-appdata：///local/ 保存到本地存储的图像。 文件：/// 本地图像。 (仅支持桌面应用。UWP apps 不能使用此协议。)	字符串	是	无
placement	图像的位置。 “appLogoOverride” - 图像替换 Toast 通知中应用的徽标。 “hero”- 图像显示为英雄图像。 有关详细信息，请参阅 Toast 内容。	字符串	否	无
hint-crop	图像的裁剪。 “circle” - 图像裁剪为一个圆圈。 未指定 - 图像不会裁剪并显示为正方形。 有关详细信息，请参阅 Toast 内容。	字符串	否	无

 

子元素

无。

父元素

父元素	说明
binding	指定 toast 模板。 请注意，Toast 通知中只能包含一个绑定元素。

另请参阅

• Toast 内容
• 通知可视化工具