ScheduledToastNotification Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Contém o XML que define a notificação do sistema que será exibida no horário agendado.
public ref class ScheduledToastNotification sealed/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.IScheduledToastNotificationFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class ScheduledToastNotification final/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.IScheduledToastNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class ScheduledToastNotification final/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.IScheduledToastNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ScheduledToastNotification final[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Notifications.IScheduledToastNotificationFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public sealed class ScheduledToastNotification[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Notifications.IScheduledToastNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class ScheduledToastNotification[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Notifications.IScheduledToastNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ScheduledToastNotificationfunction ScheduledToastNotification(content, deliveryTime, snoozeInterval, maximumSnoozeCount)Public NotInheritable Class ScheduledToastNotification- Herança
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Exemplos
O exemplo a seguir mostra uma notificação do sistema agendada para exibição em uma hora.
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);
Comentários
Crie e inicialize uma nova instância desse objeto chamando ScheduledToastNotification.
Histórico de versão
| Versão do Windows | Versão do SDK | Valor adicionado |
|---|---|---|
| 1607 | 14393 | NotificationMirroring |
| 1607 | 14393 | RemoteId |
| 1803 | 17134 | ExpirationTime |
Construtores
| ScheduledToastNotification(XmlDocument, DateTime) |
Cria e inicializa uma nova instância de um ScheduledToastNotification que será exibida apenas uma vez. |
| ScheduledToastNotification(XmlDocument, DateTime, TimeSpan, UInt32) |
Preterido em Windows 10. Em sistemas Windows 8, cria e inicializa uma nova instância de um ScheduledToastNotification que aparece novamente após um horário especificado após a exibição inicialmente. Em Windows 10, isso funciona equivalentemente a ScheduledToastNotification(XmlDocument, DateTime). Para obter o mesmo comportamento de intervalo de soneca em Windows 10, você pode usar botões em seus notificações. |
Propriedades
| Content |
Obtém o XML que define essa notificação agendada do sistema. |
| DeliveryTime |
Obtém a hora em que essa notificação do sistema está agendada para ser exibida. |
| ExpirationTime |
Obtém ou define o tempo de expiração da notificação. |
| Group |
Obtém ou define o identificador de grupo para a notificação. |
| Id |
Obtém um valor especificado pelo desenvolvedor usado para identificar um sistema agendado específico. |
| MaximumSnoozeCount |
Obtém o número máximo de vezes para exibir essa notificação. |
| NotificationMirroring |
Obtém ou define um valor que especifica se o espelhamento de notificação está habilitado. (O espelhamento de notificação permite que uma notificação apareça em vários dispositivos.) |
| RemoteId |
Obtém ou define uma ID remota para a notificação que permite ao sistema correlacionar essa notificação com outra gerada em outro dispositivo. |
| SnoozeInterval |
Obtém a quantidade de tempo entre as ocorrências da notificação. |
| SuppressPopup |
Obtém ou define se a interface do usuário pop-up de um sistema é exibida na tela do usuário. |
| Tag |
Obtém ou define uma cadeia de caracteres que identifica exclusivamente uma notificação do sistema dentro de um Grupo. |