徽章

  • 發行項

指定徽章的值或圖像。

元素階層

<徽章>

Syntax

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

Key

? 選擇性 (零或一個)

屬性和項目

屬性

屬性 描述 資料類型 必要 預設值
value

指定預先定義之識別碼圖像的數值或字串值。 數值上，這個值可以接受任何有效的整數。 0 的值會清除識別碼，1-99 的值會顯示指定值，而任何大於 99 的值會顯示為 99+。

此屬性可以設定為整數，或具有下列其中一個值：

  • 無
  • activity
  • 警示
  • 鬧鐘 (alarm)
  • 可供使用
  • 離開 (away)
  • 忙碌 (busy)
  • 新訊息 (newMessage)
  • 暫停 (paused)
  • 正在播放 (playing)
  • 離線 (unavailable)
  • error
  • 注意 (attention)
 是 無
version

這個特定承載所開發的徽章 XML 架構版本。

 integer 否 1

 

子元素

無。

父項目

此最外層 (檔) 元素可能不會包含任何其他元素。

備註

下表顯示可用的狀態字元。

狀態 圖像 XML
無 未顯示徽章 <badge value="none"/>
activity the activity badge; two circling arrows <badge value="activity"/>
鬧鐘 (alarm) the alarm badge <badge value="alarm"/>
警示 the alert badge <badge value="alert"/>
注意 (attention) the attention badge; an exclamation point <badge value="attention"/>
可供使用 the available badge; a green dot <badge value="available"/>
離開 (away) the away badge; a yellow dot <badge value="away"/>
忙碌 (busy) 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"/>
暫停 (paused) the paused badge <badge value="paused"/>
正在播放 (playing) the playing badge <badge value="playing"/>
離線 (unavailable) the unavailable badge; a gray dot <badge value="unavailable"/>

 

另請參閱

徽章概觀

應用程式磚和徽章範例

如何在本機通知中傳送字元或數位徽章

如何清除徽章

磚與徽章的指導方針和檢查清單

規格需求

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