Share via

badge

  • [アーティクル]

バッジの値またはグリフを指定します。

要素の階層

<バッジ>

構文

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

キー

? 省略可能 (0 または 1)

属性および要素

属性

属性 説明 データ型 必須 既定値
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