ToastNotificationManager.GetTemplateContent(ToastTemplateType) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
通知で使用できるようにカスタマイズできるように、定義済みのトースト テンプレートの 1 つの XML コンテンツを取得します。
public:
static XmlDocument ^ GetTemplateContent(ToastTemplateType type);
static XmlDocument GetTemplateContent(ToastTemplateType const& type);
public static XmlDocument GetTemplateContent(ToastTemplateType type);
function getTemplateContent(type)
Public Shared Function GetTemplateContent (type As ToastTemplateType) As XmlDocument
パラメーター
- type
- ToastTemplateType
システム提供のトースト テンプレートの 1 つ。
戻り値
テンプレート XML を含む オブジェクト。
例
次の例では、GetTemplateContent メソッドの使用など、テキストと画像を含むトースト通知を作成して送信する方法を示します。
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);
注釈
完全な XML ペイロードを自分で作成する代わりに、テンプレートを取得してから、ドキュメント オブジェクト モデル (DOM) 操作関数を使用して、変更するコンテンツの部分をカスタマイズできます。 この XML を ToastNotification にパッケージ化し、このクラスの他のメソッドを使用して作成した ToastNotifier を使用してタイルに送信します。
タイル要素と属性の説明については、「タイル スキーマ 」を参照してください。
適用対象
こちらもご覧ください
- Toast notifications sample (トースト通知のサンプル)
- デスクトップ アプリからのトースト通知の送信サンプル
- トースト XML スキーマ
- トースト通知の概要
- クイック スタート: トースト通知の送信
- クイック スタート: トースト プッシュ通知の送信
- クイック スタート: デスクトップからトースト通知を送信する
- トースト通知のガイドラインとチェックリスト
- トースト通知からのアクティブ化を処理する方法
- トースト通知をオプトインする方法
- トースト通知をスケジュールする方法
- AppUserModelID を使用して、デスクトップ トースト通知を有効にする方法
- トースト テンプレート カタログ
- トースト オーディオ オプション