다음을 통해 공유

ScheduledToastNotification 생성자

  • 참조

정의

네임스페이스:
Windows.UI.Notifications

오버로드

ScheduledToastNotification(XmlDocument, DateTime)

한 번만 표시되는 ScheduledToastNotification의 새 instance 만들고 초기화합니다.
ScheduledToastNotification(XmlDocument, DateTime, TimeSpan, UInt32)

Windows 10 사용되지 않습니다. Windows 8 시스템에서 는 처음 나타난 후 지정된 시간 후에 다시 나타나는 ScheduledToastNotification의 새 instance 만들고 초기화합니다. Windows 10 이 함수는 ScheduledToastNotification(XmlDocument, DateTime)과 동일합니다. Windows 10 동일한 다시 알림 간격 동작을 수행하려면 알림에 단추를 사용할 수 있습니다.

ScheduledToastNotification(XmlDocument, DateTime)

편집

한 번만 표시되는 ScheduledToastNotification의 새 instance 만들고 초기화합니다.

public:
 ScheduledToastNotification(XmlDocument ^ content, DateTime deliveryTime);
 ScheduledToastNotification(XmlDocument const& content, DateTime const& deliveryTime);
public ScheduledToastNotification(XmlDocument content, System.DateTimeOffset deliveryTime);
function ScheduledToastNotification(content, deliveryTime)
Public Sub New (content As XmlDocument, deliveryTime As DateTimeOffset)

매개 변수

content
XmlDocument

알림 메시지 콘텐츠를 정의하는 XML입니다.

deliveryTime
DateTime DateTimeOffset

Windows에서 알림 메시지를 표시해야 하는 날짜 및 시간입니다. 이 시간 전에 AddToSchedule을 호출해야 합니다.

예제

다음 예제에서는 이 생성자를 사용하여 알림을 만드는 것을 포함하여 1시간 안에 표시되도록 예약된 알림 메시지를 보여줍니다.

var Notifications = Windows.UI.Notifications;
var currentTime = new Date();
var seconds = 60;
var dueTime = new Date(currentTime.getTime() + seconds * 60 * 1000);
var idNumber = Math.floor(Math.random() * 100000000);  // Generates a unique ID number for the notification.

// Set up the notification text.
var toastXml = Notifications.ToastNotificationManager.getTemplateContent(Notifications.ToastTemplateType.toastText02);
var strings = toastXml.getElementsByTagName("text");
strings[0].appendChild(toastXml.createTextNode(This is a scheduled toast notification));
strings[1].appendChild(toastXml.createTextNode("Received: " + dueTime.toLocaleTimeString()));

// Create the toast notification object.
var toast = new Notifications.ScheduledToastNotification(toastXml, dueTime);
toast.id = "Toast" + idNumber;

// Add to the schedule.
Notifications.ToastNotificationManager.createToastNotifier().addToSchedule(toast);

추가 정보

적용 대상

ScheduledToastNotification(XmlDocument, DateTime, TimeSpan, UInt32)

편집

Windows 10 사용되지 않습니다. Windows 8 시스템에서 는 처음 나타난 후 지정된 시간 후에 다시 나타나는 ScheduledToastNotification의 새 instance 만들고 초기화합니다. Windows 10 이 함수는 ScheduledToastNotification(XmlDocument, DateTime)과 동일합니다. Windows 10 동일한 다시 알림 간격 동작을 수행하려면 알림에 단추를 사용할 수 있습니다.

public:
 ScheduledToastNotification(XmlDocument ^ content, DateTime deliveryTime, TimeSpan snoozeInterval, unsigned int maximumSnoozeCount);
 ScheduledToastNotification(XmlDocument const& content, DateTime const& deliveryTime, TimeSpan const& snoozeInterval, uint32_t const& maximumSnoozeCount);
public ScheduledToastNotification(XmlDocument content, System.DateTimeOffset deliveryTime, System.TimeSpan snoozeInterval, uint maximumSnoozeCount);
function ScheduledToastNotification(content, deliveryTime, snoozeInterval, maximumSnoozeCount)
Public Sub New (content As XmlDocument, deliveryTime As DateTimeOffset, snoozeInterval As TimeSpan, maximumSnoozeCount As UInteger)

매개 변수

content
XmlDocument

알림 메시지 콘텐츠를 정의하는 XML입니다.

deliveryTime
DateTime DateTimeOffset

Windows에서 먼저 알림 메시지를 표시해야 하는 날짜와 시간입니다. 이 시간 전에 AddToSchedule을 호출해야 합니다.

snoozeInterval
TimeSpan TimeSpan

알림 발생 사이의 시간입니다. 유효하려면 이 값이 60초 이하이고 60분 이상이어야 합니다.

maximumSnoozeCount
UInt32

unsigned int

uint32_t

이 알림을 표시할 최대 횟수입니다. 유효한 값의 범위는 1에서 5까지입니다.

예제

다음 예제에서는 알림을 만들기 위해 이 생성자를 사용하여 알림을 표시하는 것을 포함하여 1시간 안에 표시되도록 예약된 알림 메시지를 보여 하며 알림을 표시하기 위해 다시 알림 간격을 60초 및 최대 5회 지정합니다.

var Notifications = Windows.UI.Notifications;
var currentTime = new Date();
var seconds = 60;
var dueTime = new Date(currentTime.getTime() + seconds * 60 * 1000);
var idNumber = Math.floor(Math.random() * 100000000);  // Generates a unique ID number for the notification.

// Set up the notification text.
var toastXml = Notifications.ToastNotificationManager.getTemplateContent(Notifications.ToastTemplateType.toastText02);
var strings = toastXml.getElementsByTagName("text");
strings[0].appendChild(toastXml.createTextNode(This is a scheduled toast notification));
strings[1].appendChild(toastXml.createTextNode("Received: " + dueTime.toLocaleTimeString()));

// Create the toast notification object.
var toast = new Notifications.ScheduledToastNotification(toastXml, dueTime, 60 * 1000, 5);
toast.id = "Toast" + idNumber;

// Add to the schedule.
Notifications.ToastNotificationManager.createToastNotifier().addToSchedule(toast);

설명

이러한 유형의 다시 알림 간격 예약 알림은 알람과 유사한 다시 알림 기능에 적합합니다. instance 경우 앱에서 알림이 일정에서 명시적으로 제거되지 않는 한 최대 다시 알림 수에 도달할 때까지 5분마다 알림이 표시될 수 있습니다.

중요

사용자가 터치 또는 클릭을 통해 알림을 활성화하면 앱이 일정에서 알림을 제거할 책임이 있습니다. 이렇게 하지 않으면 사용자가 이미 처리한 경우에도 최대 다시 알림 수에 도달할 때까지 알림이 다시 표시될 수 있습니다.

월 또는 연도와 같은 긴 다시 알림 간격을 예약하려면 이 방법 대신 개별 예약된 알림을 사용하는 것이 좋습니다. 그러면 일광 절약 시간 또는 윤년으로 인한 타이밍 오류를 방지할 수 있습니다.

다음 코드는 최대 3회 동안 5분마다 myData 에서 시작하는 알림을 표시하는 이 메서드에 대한 호출을 보여 줍니다.

new ScheduledToastNotification(toast1, myDate, 60000, 3)

추가 정보

적용 대상