scheduleFile — schedule a new alarm which displays the contents of a text or image file.
bool scheduleFile(const KURL&URL
, const QString&dateTime
, intlateCancel
, intflags
, const QString&bgColor
, const KURL&audioURL
, intreminder
, const QString&recurrence
, intsubRepeatInterval
, intsubRepeatCount
)
bool scheduleFile(const KURL&URL
, const QString&dateTime
, intlateCancel
, intflags
, const QString&bgColor
, const KURL&audioURL
, intreminder
, intrecurType
, intrecurInterval
, intrecurCount
)
bool scheduleFile(const KURL&URL
, const QString&dateTime
, intlateCancel
, intflags
, const QString&bgColor
, const KURL&audioURL
, intreminder
, intrecurType
, intrecurInterval
, const QString&endDateTime
)
URL
Specifies the text or image file whose contents are to be displayed in the message to be scheduled.
dateTime
Specifies the scheduled date, or date and time, at which the
file should be displayed. For a date-only alarm, the string should
be in the format “YYYY-MM-DD” (as returned by
QDate::toString(Qt::ISODate)
). For an alarm
with a date and time, the string should be in the format
“YYYY-MM-DDTHH:MM[:SS]” (as returned by
QDateTime::toString(Qt::ISODate)
) or
“HH:MM[:SS]” (as returned by
QTime::toString(Qt::ISODate)
). If no date is
specified, today's date is used. Note that any seconds value is
ignored.
lateCancel
Causes the alarm to be canceled if it cannot be triggered within the specified number of minutes after the alarm's scheduled time. If the value is 0, the alarm will not be canceled no matter how late it is triggered.
flags
Specifies the logical OR of the desired alarm flags. The flag
bits are those defined in class KAlarmIface
in
kalarmiface.h
. Note that not all flag bits are
applicable to file alarms.
bgColor
Specifies the background color for displaying the file. The
string may be in the format “#RRGGBB” (as returned by
QColor::name()
) where RR, GG and BB are
two-digit hexadecimal values for red, green and blue. Alternatively
the string may be in any of the other formats accepted by
QColor::setNamedColor()
, such as a name from
the X color database (for example, “red” or
“steelblue”). Set the string to null to specify the
current default background color.
audioURL
Specifies the audio file which is to be played when the message is displayed. Set the value to null if no audio file is to be played.
reminder
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.
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.
recurType
Specifies the recurrence type for the alarm. The permissible
values are MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. These
are defined in class KAlarmIface
in
kalarmiface.h
. Monthly recurrences are of the
day of the month type, and yearly recurrences are of the date in
the year type, with the date in both cases taken from the
dateTime
parameter.
recurInterval
Specifies the number of periods
(minutes/days/weeks/months/years as specified by
recurType
) between recurrences of the
alarm.
recurCount
Specifies the number of times that the alarm should be repeated. Specify -1 to repeat the alarm indefinitely.
endDateTime
Specifies the end date, or date and time, for recurrences of the
alarm. If dateTime
includes a time, this
parameter must also include a time; if dateTime
contains only a date, this parameter must also contain only a
date.
subRepeatInterval
Specifies the number of minutes between sub-repetitions of the alarm. Specify 0 for no sub-repetition. Ignored if no recurrence is specified.
subRepeatCount
Specifies the number of sub-repetitions of the alarm, including the initial occurrence.
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 path or URL and omitting the
foreground color and font, its usage is identical to
scheduleMessage
- see the description of that function for further details.
Would you like to comment or contribute an update to this page?
Send feedback to the TDE Development Team