ToastNotificationManager Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.UI.Notifications

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

Condividi tramite