handleEvent
Prev
Next

Name

handleEvent — trigger or cancel an already scheduled alarm.

Synopsis

void handleEvent(const QString& calendarFile,
                 const QString& eventID)

Parameters

calendarFile

Specifies the (not path) of the calendar file containing the event to be displayed/executed or canceled.

eventID

Specifies the unique ID of the event to be displayed/executed or canceled, as stored in calendarFile.

Description

handleEvent() is a call to display/execute or cancel the specified alarm. 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, the scheduled trigger time was longer than late-cancel minutes ago, does not display or execute the alarm; otherwise, displays or executes the alarm. If no repetitions of the alarm are still scheduled, then deletes the alarm from the calendar file.

Note

The calendarFile parameter is only used for integrity checking: if the does not specify 's current default calendar file, the request will be ignored.

Prev
Next
Home


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team