badge

3 out of 5 rated this helpful - Rate this topic

Specifies a badge's value or glyph.

Element hierarchy

<badge>

Syntax

<badge value    = "1-99" | "none" | "activity" | "alert" | "available" | "away" | ...
       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
  • 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"/>
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

 

 

Build date: 10/26/2012

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.