Verwenden der OS X-Mitteilungszentrale

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu OS X-Anwendungsentwicklung


Durch lokale Mitteilungen können Hintergrund- oder inaktive Anwendungen Benutzer darüber informieren, dass ein Ereignis aufgetreten ist, das von Interesse ist oder die App betrifft. In diesem Thema werden die grundlegenden Schritte für die Verwendung von lokalen Mitteilungen für OS X-Anwendungen beschrieben.

In Mountain Lion (OS X 10.8) wurden die Mitteilungsfunktionen und die Mitteilungszentrale hinzugefügt. Diese entspricht weitgehend der iOS-Mitteilungszentrale, in der Sie lokale Mitteilungen terminieren oder sofort anzeigen können.

Mitteilungsarten

In OS X gibt es drei Arten von Mitteilungen:

Mitteilungsart Beschreibung Vorschau

Hinweis

Wird in der rechten oberen Ecke auf dem Mac angezeigt. Der Hinweis verbleibt auf dem Bildschirm, bis der Benutzer eine Aktion ausführt.

Notification Alert.png

Banner

Wird für eine kurze Zeit in der rechten oberen Ecke auf dem Mac angezeigt und gleitet dann nach rechts aus dem Bildschirm.

Notification Banner.png

Kennzeichen

Ein rotes Kennzeichen mit einer Zahl wird rechts oben auf dem Symbol einer App angezeigt. Die Zahl gibt die Anzahl der Mitteilungen an, die für Sie in einer App vorhanden sind.

Hinweis: Das Kennzeichen wird nicht unterstützt. Ein Beispiel der Implementierung von Kennzeichen ohne Verwendung der Komponente TNotificationCenter finden Sie unter OSX Dock Badges

Zugreifen auf den Mitteilungsdienst

RAD Studio stellt die Komponente TNotificationCenter bereit, über die Sie schnell auf den Mitteilungsdienst zugreifen können.

Um auf den Mitteilungsdienst zuzugreifen, legen Sie eine TNotificationCenter-Komponente auf Ihrem Formular ab.

  • RAD Studio fügt die folgende Unit für Delphi hinzu:
uses
  System.Notification;
  • RAD Studio fügt den folgenden include-Operator der Projekt-Header-Datei für C++ hinzu:
#include <System.Notification.hpp>

Mitteilungszentrale unter OS X

Alle Mitteilungen (EN), für die keine Aktionen ausgeführt werden, werden in die Mitteilungszentrale übernommen. Wenn eine Popup-Mitteilung auf dem Bildschirm erscheint und der Benutzer nicht darauf klickt, wird sie in die Mitteilungszentrale übernommen. Hinweise verbleiben so lange in der Mitteilungszentrale, bis der Benutzer die geeignete Aktion ausführt.

Sie können die Mitteilungszentrale ein- und ausblenden, indem Sie einfach auf der rechten Seite der Menüleiste auf Notification Center icon.png klicken. Wenn der Benutzer in der Mitteilungszentrale auf eine Mitteilung klickt, wird die App geöffnet oder in den Vordergrund gesetzt.

Notification Center on Menu Bar.png

Eine Mitteilung kann als Popup-Banner oder als Hinweis angezeigt werden, wenn die App im Hintergrund ausgeführt wird oder inaktiv ist. Der Benutzer kann die Art und Weise festlegen, wie diese Mitteilungen in OS X dargestellt werden:

Notifications Icon.png

  1. Öffnen Sie Systemeinstellungen > Mitteilungen.
  2. Suchen Sie links die App.
  3. Wählen Sie Keine, Banner oder Hinweise.
Hinweis: Wenn der Benutzer Keine auswählt, wird keine Popup-Mitteilung angezeigt, und Mitteilungen werden direkt in die Mitteilungszentrale übernommen. Standardmäßig zeigt Ihre App das Mitteilungsbanner an.

Der folgende Screenshot zeigt das Konfigurationsfenster der Mitteilungszentrale:

OSXNotificationCenter.png

Erstellen von Mitteilungen

Damit Ihre App lokale Mitteilungen unter OS X anzeigen kann, müssen Sie eine Instanz des Klassenobjekts TNotification erstellen. Sie können diese Instanz mit der Methode System.Notification.TNotificationCenter.CreateNotification erstellen.

Beim Erstellen eines lokalen Mitteilungsobjekts kann die App die Mitteilung entweder mit dem Betriebssystem terminieren oder sie sofort anzeigen. Lokale Mitteilungen eignen sich ideal für Apps mit zeitbasiertem Verhalten. Sie können die Uhrzeit festlegen, zu der das Betriebssystem die Mitteilung liefert; die Uhrzeit wird auch Auslösungszeitpunkt genannt. Sie können die geplante Mitteilung auch wiederholen.

So nehmen Sie Mitteilungen in Ihre OS X-Apps auf:

  1. Erstellen Sie eine Instanz der Klasse TNotification.
  2. Erstellen Sie mit CreateNotification eine Mitteilung.
  3. Legen Sie die Felder Name, AlertBody und FireDate fest.

Mitteilungen verbleiben in der Mitteilungszentrale, bis Sie sie löschen.

Jede Mitteilung ist durch die Eigenschaft Name des TNotification-Objekts eindeutig festgelegt.

So aktualisieren oder löschen Sie eine Mitteilung:

  • Um eine geplante Mitteilung zu aktualisieren, rufen Sie erneut die Methode ScheduleNotification mit einer Instanz von TNotificationCenter auf, die denselben Namen (Eigenschaft Name) hat.
  • Um eine Mitteilung zu stornieren, rufen Sie die Methode CancelNotification mit dem verwendeten Bezeichner auf.
  • Um alle Mitteilungen zu stornieren, rufen Sie die Methode CancelAll auf.

Siehe auch