Condividi tramite

ToastNotification Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.UI.Notifications
Modifica

Definisce il contenuto, i metadati e gli eventi associati e l'ora di scadenza di una notifica di tipo avviso popup.

public ref class ToastNotification sealed
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.IToastNotificationFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class ToastNotification 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.IToastNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class ToastNotification 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.IToastNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ToastNotification final
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Notifications.IToastNotificationFactory), 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 ToastNotification
[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.IToastNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class ToastNotification
[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.IToastNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ToastNotification
function ToastNotification(content)
Public NotInheritable Class ToastNotification
Ereditarietà
Object Platform::Object IInspectable ToastNotification
Attributi
ActivatableAttribute ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Per indicazioni su come implementare notifiche di tipo avviso popup nell'app, vedere Inviare una notifica di avviso popup locale dalle app C#.

Linee guida per la gestione dell'attivazione delle app per le notifiche di tipo avviso popup:

  • Le applicazioni UWP devono usare OnActivated per gestire le attivazioni di tipo avviso popup.
  • A partire da WinRT Build 19041, le app in pacchetto (incluse le app in pacchetto con posizione esterna) sono in grado di usare ToastNotificationActionTrigger per gestire le attivazioni per altri dettagli.
  • Le app desktop possono usare l'attivazione COM seguendo Desktop - Invia avviso popup locale.
  • Se nessuna delle opzioni di attivazione è adatta all'applicazione, seguire l'esempio in questo documento per l'uso corretto dei gestori eventi.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1607 14393 NotificationMirroring
1607 14393 RemoteId
1703 15063 Dati
1703 15063 Priorità
1903 18362 ExpiresOnReboot

Costruttori

ToastNotification(XmlDocument)

Crea e inizializza una nuova istanza di ToastNotification.

Proprietà

Content

Ottiene il codice XML che definisce la notifica di tipo avviso popup corrente.
Data

Ottiene o imposta informazioni aggiuntive sullo stato della notifica di tipo avviso popup.
ExpirationTime

Ottiene o imposta l'ora dopo la quale non deve essere visualizzata una notifica di tipo avviso popup.
ExpiresOnReboot

Indica se la notifica di tipo avviso popup rimarrà nel Centro notifiche dopo un riavvio.
Group

Ottiene o imposta l'identificatore del gruppo per la notifica.
NotificationMirroring

Ottiene o imposta un valore che specifica se è consentito il mirroring delle notifiche.
Priority

Ottiene o imposta la priorità della notifica di tipo avviso popup.
RemoteId

Ottiene o imposta un ID remoto per la notifica che consente al sistema di correlare questa notifica con un'altra generata in un altro dispositivo.
SuppressPopup

Ottiene o imposta se l'interfaccia utente popup di un avviso popup viene visualizzata nella schermata dell'utente.
Tag

Ottiene o imposta l'identificatore univoco di questa notifica all'interno del gruppo di notifica.

Eventi

Activated

Si verifica quando l'utente attiva una notifica di tipo avviso popup tramite un clic o un tocco. App che eseguono la sottoscrizione a questo evento.
Dismissed

Si verifica quando una notifica di tipo avviso popup lascia la schermata, scaduta o ignorata in modo esplicito dall'utente. App che eseguono la sottoscrizione a questo evento.
Failed

Si verifica quando un errore viene causato quando Windows tenta di generare una notifica di tipo avviso popup. App che eseguono la sottoscrizione a questo evento.

Si applica a

Vedi anche