handleEvent — trigger or cancel an already scheduled alarm.
void handleEvent(const QString&calendarFile
, const QString&eventID
)
handleEvent()
is a DCOP call to
display/execute or cancel the specified alarm. KAlarm retrieves the
alarm from the calendar file and then determines what action to take
depending on when the alarm is due.
If the alarm is not yet due, nothing happens.
If the alarm is due, it acts as follows. If a late-cancel value is set and the alarm is too late, i.e. the scheduled trigger time was longer than late-cancel minutes ago, KAlarm does not display or execute the alarm; otherwise, KAlarm displays or executes the alarm. If no repetitions of the alarm are still scheduled, KAlarm then deletes the alarm from the calendar file.
The calendarFile
parameter is
only used for integrity checking: if the URL does not specify
KAlarm's current default calendar file, the request will be
ignored.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team