badge

  • 项目

指定锁屏提醒的值或字形。

元素层次结构

<徽章>

语法

<badge value    = "1-99" | "none" | "activity" | "alert" | "alarm" | "available" | ...
       version? = integer />

键

? 可选 (零或一个)

特性和元素

特性

属性 说明 数据类型 必须 默认值
value

指定预定义锁屏提醒字形的数字值或字符串值。 就数字而言，此值可接受任何有效的整数。 值为 0 清除锁屏提醒，值为 1-99 显示给定值，任何大于 99 的值显示为 99+。

此属性可设置为整数或具有以下值之一：

  • none
  • activity
  • 警报
  • 闹钟
  • 可用
  • 离开
  • 忙碌
  • newMessage
  • 已暂停
  • 正在播放
  • 没空
  • error
  • 注意
 是 无
version

为此特定有效负载开发的锁屏提醒 XML 架构的版本。

 integer 否 1

 

子元素

无。

父元素

此最外部 (文档) 元素可能不包含任何其他元素。

注解

此表显示可用状态标志符号。

状态 标志符号 XML
无 未显示锁屏提醒 <badge value="none"/>
activity the activity badge; two circling arrows <badge value="activity"/>
闹钟 the alarm badge <badge value="alarm"/>
警报 the alert badge <badge value="alert"/>
注意 the attention badge; an exclamation point <badge value="attention"/>
可用 the available badge; a green dot <badge value="available"/>
离开 the away badge; a yellow dot <badge value="away"/>
忙碌 the busy badge; a red dot <badge value="busy"/>
error the error badge; an x <badge value="error"/>
newMessage the new mail badge; an envelope <badge value="newMessage"/>
已暂停 the paused badge <badge value="paused"/>
正在播放 the playing badge <badge value="playing"/>
没空 the unavailable badge; a gray dot <badge value="unavailable"/>

 

另请参阅

锁屏提醒概述

应用磁贴和锁屏提醒示例

如何在本地通知中发送字形或数字锁屏提醒

如何清除锁屏提醒

磁贴和锁屏提醒指南和清单

要求

值
Namespace http://schemas.microsoft.com/notifications/2012/badge.xsd