Name

scheduleCommand — schedule a new alarm which executes a shell command.

Synopsis

bool scheduleCommand(const QString& commandLine, const QDateTime& dateTime, int flags, const QString& recurrence)
bool scheduleCommand(const QString& commandLine, const QDateTime& dateTime, int flags, int simpleRepeatType, int interval, int repeatCount)
bool scheduleCommand(const QString& commandLine, const QDateTime& dateTime, int flags, int simpleRepeatType, int interval, const QDateTime& endTime)

Parameters

commandLine

Specifies the shell command line whose execution is to be scheduled.

dateTime

Specifies the scheduled date and time at which the command should be executed.

flags

Specifies the logical OR of the desired alarm flags. The flag bits are those defined in class KAEvent in alarmevent.h except that the BEEP flag bit is ignored.

recurrence

Specifies a regular recurrence for the alarm, using iCalendar syntax as defined in RFC2445. For example, “FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO” would specify 4 repetitions at 3-monthly intervals on the last Monday of the month. For a non-recurring alarm, specify an empty string.

simpleRepeatType

Specifies the recurrence type for the alarm. The permissible values are MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. These are defined in class KAEvent in alarmevent.h.

interval

Specifies the number of periods (minutes/days/weeks/months/years) between repetitions of the alarm.

repeatCount

Specifies the number of times that the alarm should be repeated. Specify -1 to repeat the alarm indefinitely.

Description

scheduleCommand() is a DCOP call to schedule the specified shell command line for execution at the specified date and time. Apart from specifying a command line and omitting the message color and audio file parameters, its usage is identical to scheduleMessage - see the description of that function for further details.