Hinweis:
Bei den meisten Flags ist mir nicht wirklich klar, was sie genau bewirken. Ich habe mich zwar um eine passende Übersetzung
bemüht, bin mir aber nicht sicher on das überall gelungen ist. Im Zweifelsfall bitte die verlinkte Originalreferenz
benutzen.
Referenz UrsIntent
Eigenschaften
Der Aktionstyp (ActionType) bestimmt, welche Aktion mit dem Intent ausgelöst wird:
- None: Beim Antippen der Benachrichtigung oder der Aktionsschaltfläche geschieht nichts.
- Screen: Beim Antippen der Benachrichtigung wird der bezeichnete Screen der eigenen App geöffnet.
- Launcher: Beim Antippen der Benachrichtigung wird eine beliebige App geöffnet. Siehe hierzu auch die ActivityStarter-Dokumentation des App Inventor.
- Event: Das Ereignis UrsNotification.OnClick wird ausgelöst.
- GoBack: Das Benachrichtigungsfenster (Notification Panel) wird geschlossen und zu letzten ausgeführten App zurück gekehrt.
Über die Eigenschaft ID können die Intents beim OnClick-Ereignis unterschieden werden. Wenn man also bei einer Benachrichtigung mit Aktionsschaltflächen das OnClick-Ereignis nutzen will, muss für die eigentliche Benachrichtigung und für jede Aktionsschaltfläche eine andere UrsIntent-Instanz übergegeben werden, die sich mindestens in der ID unterscheiden. Die ID der zugehörigen UrsIntent-Instanz wird dem OnClick-Ereignis übergeben.
Die weiteren Felder werden nur bei ActionType Screen oder Launcher ausgewertet. Die Spalte S markiert Felder die für den ActionType Screen relevant sind, die Spalte L die für den ActionType Launcher.
Zu den Flags siehe auch: Über den BackStack (Activity Stack)
| Bezeichnung | Typ | S | L | Funktion | Voreinstellung |
|---|---|---|---|---|---|
| ActionType | choice (nur im Designer) |
X | X | Legt den Aktionstyp fest. Mögliche Werte sind None, Screen, Launcher, Event oder GoBack. Je nach Aktionstyp werden verschiedene Felder ausgewertet. | None |
| ActivityAction | text | - | X | Die auszuführende allgemeine Aktion. | -none- |
| ActivityClass | text | - | X |
Gibt den Klassenteil der spezifischen Komponente an, die gestartet werden soll. ActivityPackage und ActivityClass definieren die Activity, die beim Antippen der Benachrichtigung gestartet werden soll. |
-none- |
| ActivityPackage | text | - | X | Gibt den Paketnamen der spezifischen Komponente an, die gestartet werden soll. ActivityPackage und ActivityClass definieren die Activity, die beim Antippen der Benachrichtigung gestartet werden soll. |
-none- |
| DataType | text | - | X | Gibt den MIME-Typ an, der an die Activity übergeben werden soll | -none- |
| DataUri | text | - | X | Gibt den Daten-URI an, der zum Starten der Activity verwendet wird. | -none- |
| Extras | Liste von Paaren | - | X | Fügt dem Intent erweiterte Daten hinzu (siehe unten). | -none- |
| FlagClearTask | boolean | X | X | Die gestartete Aktivität wird ein neuer Task im Verlaufsstapel. | false |
| FlagClearTop | boolean | X | X | Wenn die zu startende Activity bereits in dem aktuellen Task ausgeführt wird, wird keine neue Instanz dieser Activity gestartet. Stattdessen werden alle anderen darüber liegenden Activitys geschlossen und dieser Intent an die alte Aktivität, jetzt an der Spitze des Activity-Stacks, als neuer Intent übergeben. | false |
| FlagExcludeFromRecent | boolean | X | X | Die neue Activity wird nicht in der Liste der kürzlich gestarteten Activitys gespeichert. | false |
| FlagNewTask | boolean | X | X | Diese Activity wird zum Beginn eines neuen Task in diesem Verlaufsstapel. | false |
| FlagNoAnimation | boolean | X | X | Dieses Flag verhindert, dass das System eine Aktivitätsübergangsanimation erzeugt, um zum nächsten Aktivitätsstatus zu gelangen. | false |
| FlagNoHistory | boolean | X | X | Die neue Activity wird nicht im Verlaufsstapel gespeichert. Sobald der Benutzer sie verlässt, ist die Activity beendet. | false |
| FlagPreviousIsTop | boolean | X | X | Wenn dieser Intent dazu verwendet wird, um eine neue Activity zu starten, wird die aktuelle Activity nicht als oberste Activity gewertet. Die vorherige Activity wird als oberste Activity verwendet, wobei davon ausgegangen wird, dass die aktuelle Activity sofort beendet wird. | false |
| FlagReorderToFront | boolean | X | X | Dieses Flag bewirkt, dass die gestartete Activity an die Spitze des Verlaufsstapels verschoben wird, wenn sie bereits ausgeführt wird. | false |
| FlagResetTaskIfNeeded | boolean | X | X | Wird diese Activity entweder in einem neuen Task gestartet oder an die Spitze eines vorhandenen Task gebracht, wird sie als Einstieg für den Task gestartet. Dies führt dazu, dass alle Zugehörigkeiten erstellt werden, die erforderlich sind, um diesen Task in den richtigen Zustand zu versetzen (Activity hineinverschieben oder entfernen) oder diesen Task bei Bedarf einfach in seinen Ausgangszustand zurückzusetzen. | false |
| FlagSingleTop | boolean | X | X | Wenn gesetzt, wird die Activity nicht gestartet, wenn sie bereits oben im Verlaufsstapel ausgeführt wird. | false |
| FlagTaskOnHome | boolean | X | X | Dieses Flag bewirkt, dass ein neu startender Task über der aktuellen Home Activity (falls vorhanden) platziert wird. Das heißt, wenn der Benutzer die Back-Taste drückt, wird er immer wieder zum Home Screen zurückkehren, auch wenn dies nicht die letzte Activity war, die er ausgeführt hat. Dies kann nur in Verbindung mit FLAG_ACTIVITY_NEW_TASK verwendet werden. | false |
| ID | text | X | X | Eindeutige ID dieses Intent. | -none- |
| ScreenStartValue | text | X | - | Der Startwert, der dem zu öffnenden Screen übergeben werden soll. Abrufbar
per Control.getStartValue
 . |
-none- |
| ScreenToOpen | text | X | - | Der Name des Screens, der beim Antippen der Benachrichtigung geöffnet werden soll. | "Screen1" |
Extras hinzufügen
Die Extra-Werte sind eine Liste von Paaren. Der erste Wert ist der Schlüssel für das Paar (z.B. "Extra1") der zweite Wert ist der zugehörige Wert (z.B. "Value1").