Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

TimeUpdateService Class Reference
[QtBaseModule]

The TimeUpdateService class provides the TimeUpdate service. More...

    #include <TimeUpdateService>

Inherits QtopiaAbstractService.

• List of all members, including inherited members

Public Slots

• void storeExternalSource ( QString sourceid, uint time, int time_zone, int dstoffset )
• void updateFromExternalSources ( bool autotz, bool autotm, bool ask_tz, bool ask_time )

• 1 public slot inherited from QObject

Additional Inherited Members

• 1 property inherited from QObject
• 29 public functions inherited from QObject
• 1 signal inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QObject
• 1 protected function inherited from QtopiaAbstractService
• 7 protected functions inherited from QObject
• 2 protected variables inherited from QObject

Detailed Description

The TimeUpdateService class provides the TimeUpdate service.

The TimeUpdate service monitors time and timezone data from sources such as the modem and updates the system time and timezone accordingly.

The following settings control the automatic update:

Trolltech/locale/Location/TimezoneAuto

Trolltech/locale/Location/TimeAuto

Trolltech/locale/Location/TimezoneAutoPrompt

Trolltech/locale/Location/TimeAutoPrompt

Member Function Documentation

void TimeUpdateService::storeExternalSource ( QString sourceid, uint time, int time_zone, int dstoffset )   [slot]

Records an external time update from a source identified by sourceid. The recorded time is time (a UNIX time_t measuring UTC seconds since the start of 1970), in the given time_zone (the number of minutes east of GMT), with dstoffset minutes of daylight savings adjustment already applied to the time_zone.

This time is recorded and may be used immediately or in the future upon user request.

The sourceid is currently not used, so only one source should be enabled.

void TimeUpdateService::updateFromExternalSources ( bool autotz, bool autotm, bool ask_tz, bool ask_time )   [slot]

Analyzes the most recent external time information and updates the time zone if autotz, and the time if autotm, prompting respectively if ask_tz and ask_time. Only a single prompt is ever used, if at all.

To avoid annoying the user, changes of less than 60 seconds are applied without prompting if autotm is true.