ToastNotificationManager 클래스

정의

네임스페이스:

Windows.UI.Notifications

알림 메시지를 발생시키는 데 사용하는 ToastNotifier 개체를 만듭니다. 또한 이 클래스는 시스템에서 제공하는 알림 템플릿의 XML 콘텐츠에 대한 액세스를 제공하므로 알림에 사용할 콘텐츠를 사용자 지정할 수 있습니다.

public ref class ToastNotificationManager abstract sealed

/// [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 ToastNotificationManager final

[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 ToastNotificationManager

Public Class ToastNotificationManager

상속

Object Platform::Object IInspectable ToastNotificationManager

특성

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 및 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);

설명

데스크톱 앱에서 알림 메시지 보내기

일반적으로 데스크톱 앱에서 알림 메시지를 보내는 것은 UWP 앱에서 보내는 것과 동일합니다. 그러나 다음과 같은 차이점과 요구 사항을 알고 있어야 합니다.

• 데스크톱 앱에서 알림을 표시하려면 시작 화면에 바로 가기가 있어야 합니다.
• 바로 가기에는 AppUserModelID가 있어야 합니다.
• 데스크톱 앱은 알림을 예약할 수 없습니다.

자세한 내용은 다음 항목을 참조하세요.

• AppUserModelID를 통해 데스크톱 알림 메시지를 사용하는 방법
• 빠른 시작: 바탕 화면에서 알림 메시지 보내기

버전 기록

Windows 버전	SDK 버전	추가된 값
1607	14393	ConfigureNotificationMirroring
1607	14393	GetForUser
1703	15063	GetDefault

속성

History

ToastNotificationHistory 개체를 가져옵니다.

메서드

ConfigureNotificationMirroring(NotificationMirroring)	알림 미러링이 허용되는지 여부를 지정합니다. 알림 미러링을 사용하면 알림을 여러 디바이스에서 브로드캐스트할 수 있습니다.
CreateToastNotifier()	해당 앱에 알림 메시지를 발생시킬 수 있는 호출 애플리케이션에 바인딩된 ToastNotification의 새 instance 만들고 초기화합니다.
CreateToastNotifier(String)	지정된 앱(일반적으로 동일한 패키지의 다른 앱)에 바인딩된 ToastNotification의 새 instance 만들고 초기화합니다.
GetDefault()	현재 사용자의 알림 메시지 관리자를 가져옵니다.
GetForUser(User)	지정된 사용자의 알림 메시지 관리자를 가져옵니다.
GetTemplateContent(ToastTemplateType)	미리 정의된 알림 템플릿 중 하나의 XML 콘텐츠를 가져오므로 알림에 사용할 수 있도록 사용자 지정할 수 있습니다.

추가 정보

• 알림 사용 샘플
• 데스크톱 앱에서 알림 메시지 보내기 샘플
• 알림 XML 스키마
• 알림 메시지 개요
• 빠른 시작: 알림 메시지 보내기
• 빠른 시작: 알림 메시지 보내기
• 빠른 시작: 바탕 화면에서 알림 메시지 보내기
• 알림 메시지에 대한 지침 및 검사 목록
• 알림 메시지에서 활성화를 처리하는 방법
• 알림 메시지를 옵트인하는 방법
• 알림 메시지를 예약하는 방법
• AppUserModelID를 통해 데스크톱 알림 메시지를 사용하는 방법
• 알림 템플릿 카탈로그
• 알림 오디오 옵션