次の方法で共有

Windows アプリ向けのバッジ通知

  • [アーティクル]

バッジ通知は、アプリに固有の概要情報や状態情報を伝えます。 数値 (1 から 99) またはシステム提供のグリフのセットの 1 つを指定できます。 バッジを通じて最もよく伝わる情報の例としては、オンライン ゲームのネットワーク接続状態、メッセージング アプリのユーザー状態、メール アプリ内の未読メールの数、ソーシャル メディア アプリの新しい投稿の数などがあります。

通知バッジは、アプリが実行されているかどうかに関係なく、アプリのタスク バー アイコンとスタート タイルの右下隅に表示されます。 バッジは、すべてのタイル サイズに表示できます。

Note

独自のバッジ イメージを指定することはできません。システム提供のバッジ イメージのみを使用できます。

数値バッジ

値 バッジ XML
1 から 99 までの数値。 値 0 はグリフ値 "none" に相当し、バッジをクリアします。 100 未満の数値バッジ。 <badge value="1"/>
99 を超える任意の数。 99 より大きい数値バッジ。 <badge value="100"/>

グリフ バッジ

バッジには、数値の代わりに、拡張可能でない状態グリフのセットのいずれかを表示できます。

状態 グリフ XML
なし (バッジは表示されません。) <badge value="none"/>
活動 <badge value="activity"/>
警報 <badge value="alarm"/>
アラート <badge value="alert"/>
注意を求めています <badge value="attention"/>
利用可能 <badge value="available"/>
留守 <badge value="away"/>
busy <badge value="busy"/>
エラー <badge value="error"/>
newMessage <badge value="newMessage"/>
paused <badge value="paused"/>
奏法 <badge value="playing"/>
利用不可 <badge value="unavailable"/>

バッジを作成する

以降の例で、バッジの更新を作成する方法を示します。

数値バッジを作成する

private void setBadgeNumber(int num)
{

    // Get the blank badge XML payload for a badge number
    XmlDocument badgeXml = 
        BadgeUpdateManager.GetTemplateContent(BadgeTemplateType.BadgeNumber);

    // Set the value of the badge in the XML to our number
    XmlElement badgeElement = badgeXml.SelectSingleNode("/badge") as XmlElement;
    badgeElement.SetAttribute("value", num.ToString());

    // Create the badge notification
    BadgeNotification badge = new BadgeNotification(badgeXml);

    // Create the badge updater for the application
    BadgeUpdater badgeUpdater = 
        BadgeUpdateManager.CreateBadgeUpdaterForApplication();

    // And update the badge
    badgeUpdater.Update(badge);

}

グリフ バッジを作成する

private void updateBadgeGlyph()
{
    string badgeGlyphValue = "alert";

    // Get the blank badge XML payload for a badge glyph
    XmlDocument badgeXml = 
        BadgeUpdateManager.GetTemplateContent(BadgeTemplateType.BadgeGlyph);

    // Set the value of the badge in the XML to our glyph value
    Windows.Data.Xml.Dom.XmlElement badgeElement = 
        badgeXml.SelectSingleNode("/badge") as Windows.Data.Xml.Dom.XmlElement;
    badgeElement.SetAttribute("value", badgeGlyphValue);

    // Create the badge notification
    BadgeNotification badge = new BadgeNotification(badgeXml);

    // Create the badge updater for the application
    BadgeUpdater badgeUpdater = 
        BadgeUpdateManager.CreateBadgeUpdaterForApplication();

    // And update the badge
    badgeUpdater.Update(badge);

}

バッジをクリアする

private void clearBadge()
{
    BadgeUpdateManager.CreateBadgeUpdaterForApplication().Clear();
}

サンプル コードの入手

  • 通知のサンプル
    ライブ タイルの作成、バッジの更新の送信、トースト通知の表示方法を示します。