Класс DateTimeSettings

(Sailfish::Mdm::DateTimeSettings)

Класс DateTimeSettings управляет системными датой и временем. Подробнее…

Заголовочный файл:

#include <mdm-datetime.h>

Список всех членов класса, включая унаследованные

Свойства

automaticDateTimeUpdate : bool
automaticTimeZoneUpdate : bool
ready : const bool
timeZone : QString

Публичные методы

DateTimeSettings(QObject *parent = 0)
~DateTimeSettings()
bool automaticDateTimeUpdate() const
bool automaticTimeZoneUpdate() const
bool ready() const
void setAutomaticDateTimeUpdate(bool enable)
void setAutomaticTimeZoneUpdate(bool enable)
void setDate(const QDate &date)
void setTime(int hour, int minute)
void setTimeZone(const QString &timeZone)
QStringList supportedTimeZones()
QString timeZone() const

Сигналы

void automaticDateTimeUpdateChanged()
void automaticTimeZoneUpdateChanged()
void dateTimeChanged()
void readyChanged()
void timeZoneChanged()
void timeZoneError()

Подробное описание

Класс DateTimeSettings управляет системными датой и временем.

Свойства даты/времени считаются корректными и могут быть изменены только в том случае, если значением свойства ready является true.

Для использования данного класса в qmake-настройки проекта клиента следует добавить следующее:

 CONFIG += link_pkgconfig
 PKGCONFIG += sailfishmdm

и затем #include <mdm-datetime.h>.

Пример использования:

 #include <mdm-datetime.h>
 void updateDateTimeSettings(QObject *parent)
 {
     Sailfish::Mdm::DateTimeSettings *dateTime = new Sailfish::Mdm::DateTimeSettings(parent);

     QObject::connect(dateTime, &Sailfish::Mdm::DateTimeSettings::readyChanged, dateTime {

         // Отключается автоматическое обновление часового пояса затем, чтобы можно было задавать его значением с помощью метода setTimeZone()
         dateTime->setAutomaticTimeZoneUpdate(false);

         // Отключается автоматическое обновление часового пояса затем, чтобы можно было задавать значения даты и времени с помощью
         // setDate() и setTime()
         dateTime->setAutomaticDateTimeUpdate(false);

         dateTime->setDate(QDate(2000, 12, 25));
         dateTime->setTime(15, 35);
     });
 }

Описание свойств

automaticDateTimeUpdate : bool

Истинно, если системные дата и время автоматически обновляются путём получения данных с сервера времени.

Методы доступа:

bool automaticDateTimeUpdate() const
void setAutomaticDateTimeUpdate(bool enable)

Сигнал уведомления:

void automaticDateTimeUpdateChanged()

automaticTimeZoneUpdate : bool

Истинно, если системный часовой пояс автоматически обновляется путём получения данных с сервера времени.

Методы доступа:

bool automaticTimeZoneUpdate() const
void setAutomaticTimeZoneUpdate(bool enable)

Сигнал уведомления:

void automaticTimeZoneUpdateChanged()

ready : const bool

Истинно, если свойства класса были проинициализированы и доступны для изменения.

Методы доступа:

bool ready() const

Сигнал уведомления:

void readyChanged()

timeZone : QString

Содержит значение системного часового пояса.

Методы доступа:

QString timeZone() const
void setTimeZone(const QString &timeZone)

Сигнал уведомления:

void timeZoneChanged()

См. также supportedTimeZones().

Описание методов класса

DateTimeSettings::DateTimeSettings(QObject *parent = 0)

Конструктор по умолчанию для класса DateTimeSettings.

DateTimeSettings::~DateTimeSettings()

Деструктор для класса DateTimeSettings.

[signal] void DateTimeSettings::automaticDateTimeUpdateChanged()

Сигнал испускается при изменении значения свойства automaticDateTimeUpdate.

Примечание: сигнал уведомления для свойства automaticDateTimeUpdate.

См. также automaticDateTimeUpdate().

[signal] void DateTimeSettings::automaticTimeZoneUpdateChanged()

Сигнал испускается при изменении значения свойства automaticTimeZoneUpdate.

Примечание: сигнал уведомления для свойства automaticTimeZoneUpdate.

См. также automaticTimeZoneUpdate().

[signal] void DateTimeSettings::dateTimeChanged()

Сигнал испускается при изменении системных даты и времени.

См. также setDate() и setTime().

void DateTimeSettings::setDate(const QDate &date)

Устанавливает системную дату на заданную date.

void DateTimeSettings::setTime(int hour, int minute)

Устанавливает системное время на hour и minute в 24-часовом формате.

QStringList DateTimeSettings::supportedTimeZones()

Возвращает список допустимых часовых поясов.

[signal] void DateTimeSettings::timeZoneChanged()

Сигнал испускается при изменении значения свойства timeZone.

Примечание: сигнал уведомления для свойства timeZone.

См. также timeZone().

[signal] void DateTimeSettings::timeZoneError()

Сигнал испускается, когда происходит ошибка смены значения timeZone.

См. также timeZone().