BefehlszeilenschnittstelleDie Befehlszeilenoptionen ermöglichen anderen Programmen den Aufruf von KAlarm zum Auslösen oder Löschen einer Erinnerung. Der Grund für die Verwendung der Befehlszeile liegt darin, dass KAlarm, wird es ohne Befehlszeilenparameter gestartet und über D-Bus-Aufrufe angesprochen, im grafischen Modus startet. Das ist bei der Kommunikation zwischen Programmen unerwünscht.
Anmerkung
Programme sollten zunächst prüfen, ob KAlarm bereits gestartet ist und, sofern dies der Fall ist, für die gewünschten Operationen D-Bus-Aufrufe verwenden.
Die Befehlszeilenparameter für das Festlegen einer neuen Erinnerung werden im Kapitel Befehlszeilenoptionen beschrieben. Die Optionen für das Auslösen und Löschen von Erinnerungen lauten wie folgt:
Anmerkung
Die Befehlszeilenparameter können, sofern gewünscht, von normalen Anwendern verwendet werden. Vorausgesetzt natürlich, sie sind in der Lage die nötigen Daten zu übergeben.
| Option | Beschreibung |
|---|---|
--cancelEvent | Stoppt die Erinnerung mit der angegebenen Ereignis-Kennung. eventID ist die eindeutige Kennung des Ereignisses, optional mit Präfixen des Einrichtungsnamens oder der numerischen Kennung der Ressource mit dem Ereignis. Verwenden Sie das Format [resourceID:]eventUID. Die ausgeführte Aktion entspricht dem D-Bus-Befehl cancelEvent(). Die Option --triggerEvent hier nicht angegeben werden. |
--triggerEvent | Löst die Erinnerung mit der angegebenen Ereignis-Kennung aus.eventID ist die eindeutige Kennung des Ereignisses, optional mit Präfixen des Einrichtungsnamens oder der numerischen Kennung der Ressource mit dem Ereignis. Verwenden Sie das Format [resourceID:]eventUID. Die ausgeführte Aktion entspricht dem D-Bus-Befehl triggerEvent(). Die Option --cancelEvent hier nicht angegeben werden. |
Beispiele:
%kalarm--triggerEventKAlarm-387486299.702%kalarm--cancelEventKAlarm-388886299.793