ToastNotificationManager Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.UI.Notifications
Modifica

Crea oggetti ToastNotifier usati per generare notifiche di tipo avviso popup. Questa classe fornisce inoltre l'accesso al contenuto XML dei modelli di avviso popup forniti dal sistema in modo da poter personalizzare il contenuto da usare nelle notifiche.

public ref class ToastNotificationManager abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class ToastNotificationManager final
/// [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)]
public static class ToastNotificationManager
[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
Ereditarietà
Object Platform::Object IInspectable ToastNotificationManager
Attributi
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)

Esempio

Nell'esempio seguente viene illustrato come creare e inviare una notifica di tipo avviso popup che include testo e immagini, incluso l'uso dei metodi GetTemplateContent e 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);

Commenti

Invio di notifiche di tipo avviso popup dalle app desktop

In genere, l'invio di una notifica di tipo avviso popup da un'app desktop equivale all'invio da un'app UWP. Tuttavia, è necessario tenere presenti queste differenze e requisiti:

  • Affinché un'app desktop visualizzi un avviso popup, l'app deve avere un collegamento nella schermata Start.
  • Il collegamento deve avere un AppUserModelID.
  • Le app desktop non possono pianificare un avviso popup.

Per altre informazioni, vedere gli argomenti seguenti:

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1607 14393 ConfigureNotificationMirroring
1607 14393 GetForUser
1703 15063 GetDefault

Proprietà

History

Ottiene l'oggetto ToastNotificationHistory .

Metodi

ConfigureNotificationMirroring(NotificationMirroring)

Specifica se il mirroring delle notifiche è consentito. Il mirroring delle notifiche consente di trasmettere una notifica su più dispositivi.
CreateToastNotifier()

Crea e inizializza una nuova istanza di ToastNotification, associata all'applicazione chiamante, che consente di generare una notifica di tipo avviso popup all'app.
CreateToastNotifier(String)

Crea e inizializza una nuova istanza di ToastNotification, associata a un'app specificata, in genere un'altra app nello stesso pacchetto.
GetDefault()

Ottiene una gestione notifiche di tipo avviso popup per l'utente corrente.
GetForUser(User)

Ottiene una gestione notifiche di tipo avviso popup per l'utente specificato.
GetTemplateContent(ToastTemplateType)

Ottiene il contenuto XML di uno dei modelli di avviso popup predefiniti in modo da poterlo personalizzare per l'uso nella notifica.

Si applica a

Vedi anche