Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

badge

Specifies a badge's value or glyph.

Element hierarchy

<badge>

Syntax

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

Key

?   optional (zero or one)

Attributes and Elements

Attributes

AttributeDescriptionData typeRequiredDefault value
value

Either a numeric value or a string value that specifies a predefined badge glyph. Numerically, this value can accept any valid integer. A value of 0 clears the badge, values from 1-99 display as given, and any value greater than 99 displays as 99+.

This attribute can be set to an integer or have one of the following values:

  • none
  • activity
  • alert
  • alarm
  • available
  • away
  • busy
  • newMessage
  • paused
  • playing
  • unavailable
  • error
  • attention
YesNone
version

The version of the badge XML schema this particular payload was developed for.

integerNo1

 

Child Elements

None.

Parent Elements

This outermost (document) element may not be contained by any other elements.

Remarks

This table shows the available status glyphs.

StatusGlyphXML
noneNo badge shown<badge value="none"/>
activityThe activity badge; two circling arrows<badge value="activity"/>
alarmThe alarm badge<badge value="alarm"/>
alertThe alert badge<badge value="alert"/>
availableThe available badge; a green dot<badge value="available"/>
awayThe away badge; a yellow dot<badge value="away"/>
busyThe busy badge; a red dot<badge value="busy"/>
newMessageThe new mail badge; an envelope<badge value="newMessage"/>
pausedThe paused badge<badge value="paused"/>
playingThe playing badge<badge value="playing"/>
unavailableThe unavailable badge; a gray dot<badge value="unavailable"/>
errorThe error badge; an X<badge value="error"/>
attentionThe attention badge; an exclamation point<badge value="attention"/>

 

Requirements

Namespace

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

 

 

Show:
© 2014 Microsoft. All rights reserved.