次の方法で共有

ToastNotificationManager.CreateToastNotifier メソッド

  • リファレンス

定義

名前空間:
Windows.UI.Notifications

オーバーロード

CreateToastNotifier()

呼び出し元アプリケーションにバインドされた ToastNotification の新しいインスタンスを作成して初期化します。これにより、そのアプリにトースト通知を生成できます。
CreateToastNotifier(String)

指定したアプリ (通常は同じパッケージ内の別のアプリ) にバインドされた ToastNotification の新しいインスタンスを作成して初期化します。

CreateToastNotifier()

編集

呼び出し元アプリケーションにバインドされた ToastNotification の新しいインスタンスを作成して初期化します。これにより、そのアプリにトースト通知を生成できます。

public:
 static ToastNotifier ^ CreateToastNotifier();
/// [Windows.Foundation.Metadata.Overload("CreateToastNotifier")]
 static ToastNotifier CreateToastNotifier();
[Windows.Foundation.Metadata.Overload("CreateToastNotifier")]
public static ToastNotifier CreateToastNotifier();
function createToastNotifier()
Public Shared Function CreateToastNotifier () As ToastNotifier

戻り値

ToastNotifier

トースト通知をアプリに送信するために使用するオブジェクト。

属性
OverloadAttribute

例

次の例では、CreateToastNotifier メソッドの使用など、テキストと画像を含むトースト通知を作成して送信する方法を示します。

var notifications = Windows.UI.Notifications;

// Get the toast notification manager for the current app.
var notificationManager = notifications.ToastNotificationManager;

// The getTemplateContent method returns a Windows.Data.Xml.Dom.XmlDocument object
// that contains the toast notification XML content.
var template = notifications.toastTemplateType.toastImageAndText01;
var toastXml = notificationManager.getTemplateContent(notifications.ToastTemplateType[template]);

// You can use the methods from the XML document to specify the required elements for the toast.
var images = toastXml.getElementsByTagName("image");
images[0].setAttribute("src", "images/toastImageAndText.png");

var textNodes = toastXml.getElementsByTagName("text");
textNodes.forEach(function (value, index) {
    var textNumber = index + 1;
    var text = "";
    for (var j = 0; j < 10; j++) {
        text += "Text input " + /*@static_cast(String)*/textNumber + " ";
    }
    value.appendChild(toastXml.createTextNode(text));
});

// Create a toast notification from the XML, then create a ToastNotifier object
// to send the toast.
var toast = new notifications.ToastNotification(toastXml);

notificationManager.createToastNotifier().show(toast);

注釈

デスクトップ アプリのトースト通知を作成するときは、このオーバーロードを使用しないでください。 CreateToastNotifier(appID) を使用して、必要な AppUserModelID を指定します。

アプリでバックグラウンド音声オーバーインターネット プロトコル (VOIP) エージェントを使用する場合は、トーストを表示するアプリ ID を指定する必要があります。 CreateToastNotifier(appID) メソッド のオーバーロードを使用します。

こちらもご覧ください

適用対象

CreateToastNotifier(String)

編集

指定したアプリ (通常は同じパッケージ内の別のアプリ) にバインドされた ToastNotification の新しいインスタンスを作成して初期化します。

public:
 static ToastNotifier ^ CreateToastNotifier(Platform::String ^ applicationId);
/// [Windows.Foundation.Metadata.Overload("CreateToastNotifierWithId")]
 static ToastNotifier CreateToastNotifier(winrt::hstring const& applicationId);
[Windows.Foundation.Metadata.Overload("CreateToastNotifierWithId")]
public static ToastNotifier CreateToastNotifier(string applicationId);
function createToastNotifier(applicationId)
Public Shared Function CreateToastNotifier (applicationId As String) As ToastNotifier

パラメーター

applicationId
String

Platform::String

winrt::hstring

アプリの一意の ID。

Note

セカンダリ タイルにトースト通知を送信することはできません。そのため、これはアプリ タイルの ID である必要があります。

戻り値

ToastNotifier

タイルにトースト通知を送信するために使用するオブジェクト。

属性
OverloadAttribute

注釈

applicationId によって識別されるアプリは、呼び出し元と同じパッケージに属している必要があります。

アプリでバックグラウンド音声インターネット プロトコル (VOIP) エージェントを使用する場合は、この形式の メソッドを使用して、トーストを表示するために必要なアプリ ID を指定します。

デスクトップ アプリからのトースト通知の送信

一般に、デスクトップ アプリからトースト通知を送信することは、UWP アプリから送信するのと同じです。 ただし、次の違いと要件に注意する必要があります。

  • デスクトップ アプリでトーストを表示するには、アプリのスタート画面にショートカットが必要です。
  • ショートカットには AppUserModelID が必要です。
  • デスクトップ アプリではトーストをスケジュールできません。

詳細については、以下のトピックを参照してください。

こちらもご覧ください

適用対象