Szybki start: wysyłanie powiadomień toast z pulpitu
W tym przewodniku szybkiego startu pokazano, jak wyświetlić powiadomienie typu toast z aplikacji komputerowej.
Warunki wstępne
- Biblioteki
- C++: Runtime.object.lib
- C#: Windows.Winmd
- Skrót do aplikacji z System.AppUserModel.IDmusi zostać zainstalowany na ekranie startowym. Należy jednak pamiętać, że nie trzeba go przypiąć do ekranu startowego. Aby uzyskać więcej informacji, zobacz Jak włączyć powiadomienia toast na pulpicie za pomocą AppUserModelID.
- Wersja programu Microsoft Visual Studio, która obsługuje co najmniej system Windows 8
Instrukcje
1. Utwórz zawartość powiadomienia
Notatka
Po określeniu szablonu powiadomienia typu toast zawierającego obraz należy pamiętać, że aplikacje klasyczne mogą używać tylko lokalnych obrazów; obrazy internetowe nie są obsługiwane. Ponadto ścieżka do lokalnego pliku obrazu musi być podana jako ścieżka bezwzględna (nie względna).
// 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. Tworzenie i dołączanie programów obsługi zdarzeń
Zarejestruj programy obsługi wyskakujących zdarzeń: aktywowane, odrzucone i nieudane. Aplikacja komputerowa musi co najmniej zasubskrybować zdarzenie Aktywowane, aby mogła obsługiwać oczekiwaną aktywację aplikacji z powiadomienia toast po wybraniu jej przez użytkownika.
toast.Activated += ToastActivated;
toast.Dismissed += ToastDismissed;
toast.Failed += ToastFailed;
3. Wyślij powiadomienie
Ważny
Musisz dołączyć AppUserModelID skrótu aplikacji na ekranie startowym za każdym razem, gdy wywołujesz CreateToastNotifier. Jeśli tego nie zrobisz, twój komunikat nie będzie wyświetlany.
ToastNotificationManager.CreateToastNotifier(appID).Show(toast);
4. Obsługa wywołań zwrotnych
Przenieś okno aplikacji na pierwszy plan, jeśli otrzyma wywołanie zwrotne "aktywowano" z powiadomienia popup. Gdy użytkownik wybierze powiadomienie, oczekuje się, że aplikacja zostanie uruchomiona i otworzy widok powiązany z zawartością tego powiadomienia.
Tematy pokrewne
-
Wysyłanie powiadomień toast z przykładowych aplikacji klasycznych
-
Jak włączyć wyskakujące powiadomienia pulpitu za pomocą AppUserModelID