ToastNotificationManager.CreateToastNotifier Metodo
Definizione
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.
Overload
CreateToastNotifier() |
Crea e inizializza una nuova istanza di ToastNotification, associata all'applicazione chiamante, che consente di generare una notifica popup a tale app. |
CreateToastNotifier(String) |
Crea e inizializza una nuova istanza di ToastNotification, associata a un'app specificata, in genere un'altra app nello stesso pacchetto. |
CreateToastNotifier()
Crea e inizializza una nuova istanza di ToastNotification, associata all'applicazione chiamante, che consente di generare una notifica popup a tale app.
public:
static ToastNotifier ^ CreateToastNotifier();
/// [Windows.Foundation.Metadata.Overload("CreateToastNotifier")]
static ToastNotifier CreateToastNotifier();
[Windows.Foundation.Metadata.Overload("CreateToastNotifier")]
public static ToastNotifier CreateToastNotifier();
function createToastNotifier()
Public Shared Function CreateToastNotifier () As ToastNotifier
Restituisce
L'oggetto che si userà per inviare la notifica di tipo avviso popup all'app.
- Attributi
Esempio
Nell'esempio seguente viene illustrato come creare e inviare una notifica di tipo avviso popup che include testo e immagini, incluso l'uso del metodo 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
Non usare questo overload durante la creazione di un notificatore popup per un'app desktop. Usare CreateToastNotifier(appID) per fornire l'appUserModelID richiesto.
Se l'app usa un agente VOIP (Voice-Over-Internet Protocol) in background, deve specificare l'ID app per visualizzare un avviso popup. Usare l'overload del metodo CreateToastNotifier(appID).
Vedi anche
- CreateToastNotifier(String)
- Esempio di notifiche di tipo avviso popup
- Esempio di invio notifiche di tipo avviso popup da app desktop
- Xml Schema di tipo avviso popup
- Panoramica delle notifiche di tipo avviso popup
- Avvio rapido: Invio di una notifica di tipo avviso popup
- Avvio rapido: Invio di una notifica push popup
- Avvio rapido: Invio di una notifica popup dal desktop
- Linee guida ed elenco di controllo per le notifiche popup
- Come gestire l'attivazione da una notifica di tipo avviso popup
- Come acconsentire esplicitamente alle notifiche di tipo avviso popup
- Come pianificare una notifica di tipo avviso popup
- Come abilitare le notifiche di tipo avviso popup sul desktop tramite un AppUserModelID
- Catalogo di modelli di tipo avviso popup
- Opzioni audio di tipo avviso popup
Si applica a
CreateToastNotifier(String)
Crea e inizializza una nuova istanza di ToastNotification, associata a un'app specificata, in genere un'altra app nello stesso pacchetto.
public:
static ToastNotifier ^ CreateToastNotifier(Platform::String ^ applicationId);
/// [Windows.Foundation.Metadata.Overload("CreateToastNotifierWithId")]
static ToastNotifier CreateToastNotifier(winrt::hstring const& applicationId);
[Windows.Foundation.Metadata.Overload("CreateToastNotifierWithId")]
public static ToastNotifier CreateToastNotifier(string applicationId);
function createToastNotifier(applicationId)
Public Shared Function CreateToastNotifier (applicationId As String) As ToastNotifier
Parametri
- applicationId
-
String
Platform::String
winrt::hstring
ID univoco dell'app.
Nota
Non è possibile inviare una notifica di tipo avviso popup a un riquadro secondario, quindi questo deve essere l'ID di un riquadro dell'app.
Restituisce
L'oggetto che si userà per inviare la notifica di tipo avviso popup al riquadro.
- Attributi
Commenti
L'app identificata da applicationId deve appartenere allo stesso pacchetto del chiamante.
Usare questa forma del metodo se l'app usa un agente di protocollo VOIP (Voice-Over-Internet) in background, per specificare l'ID app necessario per visualizzare un avviso popup in questo caso.
Invio di notifiche popup dalle app desktop
In genere, l'invio di una notifica popup da un'app desktop è uguale all'invio da un'app UWP. Tuttavia, è consigliabile tenere presente queste differenze e requisiti:
- Per visualizzare 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:
- Come abilitare le notifiche di tipo avviso popup sul desktop tramite un AppUserModelID
- Avvio rapido: Invio di una notifica popup dal desktop
Vedi anche
- CreateToastNotifier()
- Esempio di notifiche di tipo avviso popup
- Esempio di invio notifiche di tipo avviso popup da app desktop
- Xml Schema di tipo avviso popup
- Panoramica delle notifiche di tipo avviso popup
- Avvio rapido: Invio di una notifica di tipo avviso popup
- Avvio rapido: Invio di una notifica push popup
- Avvio rapido: Invio di una notifica popup dal desktop
- Linee guida ed elenco di controllo per le notifiche popup
- Come gestire l'attivazione da una notifica di tipo avviso popup
- Come acconsentire esplicitamente alle notifiche di tipo avviso popup
- Come pianificare una notifica di tipo avviso popup
- Come abilitare le notifiche di tipo avviso popup sul desktop tramite un AppUserModelID
- Catalogo di modelli di tipo avviso popup
- Opzioni audio di tipo avviso popup