![]() | scheduleFile |
Prev | DCOP interface | Next |
scheduleFile — schedule a new alarm which displays the contents of a text or image file.
bool scheduleFile(const QString& URL, const QDateTime& dateTime, const QColor& bg, int flags, const QString& audioURL, int reminder, const QString& recurrence)
bool scheduleFile(const QString& URL, const QDateTime& dateTime, const QColor& bg, int flags, const QString& audioURL, int reminder, int simpleRepeatType, int interval, int repeatCount)
bool scheduleFile(const QString& URL, const QDateTime& dateTime, const QColor& bg, int flags, const QString& audioURL, int reminder, int simpleRepeatType, int interval, const QDateTime& endTime)
Specifies the name or URL of a text or image file whose contents are to be displayed in the message to be scheduled.
Specifies the scheduled date and time at which the file should be displayed.
Specifies the background color for displaying the file.
Specifies the logical OR of the desired alarm flags. The flag bits are those defined in class KAEvent in alarmevent.h
Specifies the name or URL of an audio file which is to be played when the message is displayed.
Specifies the number of minutes in advance of the main alarm and of each of its recurrences (if any) at which a reminder alarm should be displayed. Specify 0 if no reminder is required.
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.
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.
Specifies the number of periods (minutes/days/weeks/months/years) between repetitions of the alarm.
Specifies the number of times that the file should be displayed. Specify -1 to repeat the alarm indefinitely.
scheduleFile() is a DCOP call to schedule the specified text or image file for display at the specified date and time. Apart from specifying a file name or URL and omitting the foreground color, its usage is identical to scheduleMessage - see the description of that function for further details.
Prev | Home | Next |
scheduleMessage | Up | scheduleCommand |