Delen via


Snel aan de slag: Een toastmelding vanuit het bureaublad versturen

In deze snelstartgids leert u hoe u een toast-melding vanuit een bureaublad-app kunt genereren.

Voorwaarden

  • Bibliotheken
    • C++: Runtime.object.lib
    • C#: Windows.Winmd
  • Een snelkoppeling naar uw app, met een System.AppUserModel.ID, moet zijn geïnstalleerd op het startscherm. Houd er echter rekening mee dat het niet hoeft te worden vastgemaakt aan het startscherm. Voor meer informatie, zie Hoe desktopmeldingen in te schakelen via een AppUserModelID.
  • Een versie van Microsoft Visual Studio die ten minste Windows 8 ondersteunt

Aanwijzingen

1. Uw pop-upinhoud maken

Notitie

Wanneer u een pop-upsjabloon opgeeft die een afbeelding bevat, moet u er rekening mee houden dat bureaublad-apps alleen lokale afbeeldingen kunnen gebruiken; webafbeeldingen worden niet ondersteund. Het pad naar het lokale afbeeldingsbestand moet ook worden opgegeven als een absoluut (niet relatief) pad.

 

// Get a toast XML template
XmlDocument toastXml = ToastNotificationManager.GetTemplateContent(ToastTemplateType.ToastImageAndText04);

// Fill in the text elements
XmlNodeList stringElements = toastXml.GetElementsByTagName("text");
for (int i = 0; i < stringElements.Length; i++)
{
    stringElements[i].AppendChild(toastXml.CreateTextNode("Line " + i));
}

// Specify the absolute path to an image
String imagePath = "file:///" + Path.GetFullPath("toastImageAndText.png");
XmlNodeList imageElements = toastXml.GetElementsByTagName("image");

ToastNotification toast = new ToastNotification(toastXml);

2. De eventhandlers maken en koppelen

Registreer handlers voor de notificatiegebeurtenissen: Geactiveerd, Gesloten en Mislukt. Een desktop-app moet zich ten minste abonneren op de Activated-gebeurtenis, zodat deze de verwachte activering van de app vanaf de toast kan afhandelen wanneer de gebruiker deze selecteert.

toast.Activated += ToastActivated;
toast.Dismissed += ToastDismissed;
toast.Failed += ToastFailed;

3. De melding verzenden

Belangrijk

U moet de AppUserModelID van de snelkoppeling van uw app opnemen op het startscherm telkens wanneer u CreateToastNotifier-aanroept. Als u dit niet doet, wordt uw melding niet weergegeven.

 

ToastNotificationManager.CreateToastNotifier(appID).Show(toast);

4. De callbacks verwerken

Breng het venster van uw app naar de voorgrond als er een 'geactiveerde' callback van de toastmelding wordt ontvangen. Wanneer een gebruiker een toastmelding selecteert, is de verwachting dat de app wordt gestart naar een weergave die gerelateerd is aan de inhoud van die toastmelding.

Voorbeeld van het verzenden van pop-upmeldingen vanuit bureaublad-apps

Pop-upmeldingen inschakelen via een AppUserModelID-

XML-schema voor toastbericht

Overzicht van toastmeldingen

Quickstart: Een toastmelding verzenden

Quickstart: Een toast push-notificatie verzenden

Richtlijnen en controlelijst voor toastmeldingen

Een toastmeldingssjabloon kiezen en gebruiken

Activering van een pop-upmelding afhandelen

Inschrijven voor toastmeldingen

een toast-sjabloon kiezen

audio-opties voor toastmelding