BadgeUpdateManager クラス

  • リファレンス

定義

名前空間:
Windows.UI.Notifications
編集

タイルのバッジ オーバーレイを操作するために使用する BadgeUpdater オブジェクトを作成します。 このクラスは、バッジの更新に使用するためにそのコンテンツをカスタマイズできるように、システム提供のバッジ テンプレートの XML コンテンツへのアクセスも提供します。

public ref class BadgeUpdateManager abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class BadgeUpdateManager final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class BadgeUpdateManager final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public static class BadgeUpdateManager
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class BadgeUpdateManager
Public Class BadgeUpdateManager
継承
Object Platform::Object IInspectable BadgeUpdateManager
属性
ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Windows の要件

デバイス ファミリ
Windows 10 (10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox で導入)
API contract
Windows.Foundation.UniversalApiContract (v1.0 で導入)

例

次の例は、 GetTemplateContent を使用して数値バッジのコンテンツを作成し、 CreateBadgeUpdaterForApplication を使用して、呼び出し元のアプリのタイルに数値バッジの更新を送信する方法を示しています。

function sendBadgeNotification() {
    var Notifications = Windows.UI.Notifications;
    var badgeXml;
    var badgeAttributes;

    // Get an XML DOM version of a specific template by using getTemplateContent.
    badgeXml = Notifications.BadgeUpdateManager.getTemplateContent(Notifications.BadgeTemplateType.badgeNumber);
    badgeAttributes = badgeXml.getElementsByTagName("badge");
    badgeAttributes[0].setAttribute("value", "7");

    // Create a badge notification from the XML content.
    var badgeNotification = new Notifications.BadgeNotification(badgeXml);

    // Send the badge notification to the app's tile.
    Notifications.BadgeUpdateManager.createBadgeUpdaterForApplication().update(badgeNotification);
}

注釈

バージョン履歴

Windows のバージョン SDK バージョン 追加された値
1607 14393 GetForUser

メソッド

CreateBadgeUpdaterForApplication()

BadgeUpdater の新しいインスタンスを作成して初期化します。これにより、呼び出し元アプリのタイルのバッジの外観または内容を変更できます。
CreateBadgeUpdaterForApplication(String)

指定したアプリ タイルのバッジ (通常はパッケージ内の別のアプリのタイル) の BadgeUpdater の新しいインスタンスを作成して初期化します。 BadgeUpdater を使用すると、そのバッジの外観または内容を変更できます。
CreateBadgeUpdaterForSecondaryTile(String)

BadgeUpdater の新しいインスタンスを作成して初期化します。これにより、セカンダリ タイルのバッジの外観または内容を変更できます。 タイルは、呼び出し元アプリまたは同じパッケージ内の他のアプリに属することができます。
GetForUser(User)

指定したユーザーの新しい BadgeUpdateManagerForUser を作成して初期化します。これにより、特定のユーザーのタイルのバッジの外観または内容を変更できます。
GetTemplateContent(BadgeTemplateType)

バッジの更新用にカスタマイズできるように、定義済みのバッジ テンプレートの 1 つの XML コンテンツを取得します。

適用対象

こちらもご覧ください