Qt API | Qtopia API | Qtopia Documentation | ![]() |
The AlarmServer class allows alarms to be scheduled and unscheduled. More...
#include <qtopia/alarmserver.h>
Applications can schedule alarms with addAlarm() and can unschedule alarms with deleteAlarm(). When the time for an alarm to go off is reached the specified QCop message is sent on the specified channel (optionally with additional data).
Scheduling an alarm using this class is important (rather just using a QTimer) since the machine may be asleep and needs to get woken up using the Linux kernel which implements this at the kernel level to minimize battery usage while asleep.
See also QCopEnvelope and Qtopia Classes.
If this function is called with exactly the same data as a previous call the subsequent call is ignored, so there is only ever one alarm with a given set of parameters.
See also deleteAlarm().
Passing null values for when, channel, or for the QCop message, acts as a wildcard meaning "any". Similarly, passing -1 for data indicates "any".
If there is no matching alarm, nothing happens.
See also addAlarm().
This file is part of the Qtopia , copyright © 1995-2002 Trolltech, all rights reserved.
Copyright © 2001-2002 Trolltech | Trademarks | Qtopia version 1.7.1
|