Kafelki w Windows 8 - Kolejka powiadomień  

Tłumaczenie na podstawie How to use the notification queue with local notifications (Windows Store apps using C#/VB/C++ and XAML): Aurelia Tokarek

Opublikowano: 2012-10-05

W tym odcinku nauczysz się włączać kolejkę powiadomień na Twoim kafelku. Dowiesz się również, jak przyczepić etykietę do powiadomienia przed przesłaniem go, unikając powielania lub nieaktualnej zawartości w kolejce. Kolejka powiadomień przechodzi między maksymalnie pięcioma powiadomieniami.

Uwaga! W tym odcinku manipulujesz zawartością powiadomień bezpośrednio w XML Document Object Model (DOM). Inną opcją jest dostępna biblioteka NotificationsExtensions, prezentująca zawartość XML jako właściwości obiektu, zawierająca Intellisense. Więcej informacji znajdziesz w Quickstart: Using the NotificationsExtensions library in your code. Aby zobaczyć kod zawarty w tym szybkim starcie, używający NotificationsExtensions, zobacz  App tiles and badges sample.

Co musisz wiedzieć

Technologie

• Windows Runtime.

Wymagania wstępne

Aby zrozumieć ten temat potrzebujesz:

• wiedzy praktycznej o kafelkach i warunkach powiadamiania oraz pojęciach. Więcej informacji znajdziesz w Tiles, badges, and notifications,
• znajomości schematu XML kafelka. Więcej informacji znajdziesz w Tile schema,
• umiejętności tworzenia prostej aplikacji Windows Store przy pomocy JavaScript, używającej Windows Runtime API. Więcej informacji znajdziesz w Getting started with Windows Store apps,
• istniejącego kafelka domyślnego dla Twojej aplikacji, zdefiniowanego w manifeście aplikacji. Więcej informacji znajdziesz w odcinku Kafelek domyślny,
• znajomości XML i jego manipulacji przez Document Object Model (DOM) API.

Instrukcje

1. Dodaj deklarację przestrzeni nazw.

• Windows.UI.Notifications zawiera API powiadomień:

C#

using Windows.UI.Notifications;
using Windows.Data.Xml.Dom;

2. Ustaw opcję włączającą cykliczne powiadomienia.

Ten kod włącza kolejkę powiadomień dla Twojej aplikacji. Wywoływane jest tylko, kiedy aplikacja jest uruchamiana, więc powinno znajdować się w kodzie inicjalizacyjnym:

C#

TileUpdateManager.CreateTileUpdaterForApplication().EnableNotificationQueue(true);

3.Utwórz powiadomienia kafelka.

To jest pierwszy krok we wszystkich powiadomieniach kafelków i nie różni się niczym od innych sytuacji. Ten krok został zawarty tylko dla kompletności. Więcej informacji znajdziesz w Wysyłanie aktualizacji:

C#

TileUpdateManager.GetTemplateContent(TileTemplateType.TileWideImageAndText01);
XmlDocument tileXml = TileUpdateManager.GetTemplateContent(tileTemplate);

// TODO: Fill in the template with your tile content.
// TODO: Define a square tile and add it to tileXML.

TileNotification tileNotification = new TileNotification(tileXml);

4.Przypnij etykietę do powiadomienia.

Ten krok jest opcjonalny. Etykieta jest ciągiem nie większym niż 16 alfanumerycznych znaków, plus kończący znak null, który unikalnie identyfikuje powiadomienia wewnątrz Twojej aplikacji:

C#

tileNotification.Tag = "stockMSFT";

5. Wyślij powiadomienie do kafelka.

C#

TileUpdateManager.CreateTileUpdaterForApplication().Update(tileNotification);

Podsumowanie

W tym odcinku dowiedziałeś się, jak włączać kolejki powiadomień na Twoim kafelku. W następnym odcinku nauczysz się tworzyć drugi kafelek dla aplikacji i przypinać go do ekranu startowego.