Qt4Pi

TXSLib : Class TDateTime

La classe TDateTime est un widget qui permet d'afficher ou de saisir des valeurs de date et heure.

Cette classe d'objet n'est pas compatible avec son utllisation sur un afficheur LCD. Voir la rubrique : LCD 7789 avec Qt

Ci-dessous un exemple d'un objet de la classe TDateTime en mode édition ainsi que le code de démonstration.

Dialog::Dialog(QWidget *parent)
: QDialog(parent)
{
// Initialisation de la librairie TXSLib
TXS::Init();

// Dialogue de taille fixe
setFixedSize(500,160);

// Elément de l'interface opérateur
m_pVLayout = new QVBoxLayout();
m_pHLayout = new QHBoxLayout();
m_pEditButton = new QPushButton();
m_pStopAutoUpdateButton = new QPushButton();
m_pStartAutoUpdateButton = new QPushButton();
m_pDT = new TDateTime();

// Reglage de TDateTime
m_pDT->SetCaptionVisible(false);
m_pDT->SetDateBorderVisible(false);
m_pDT->SetTimeBorderVisible(false);

// Réglage des propriétés des boutons
m_pEditButton->setText("Toggle Edit");
m_pStartAutoUpdateButton->setText("Start Update");
m_pStopAutoUpdateButton->setText("Stop Update");
m_pStartAutoUpdateButton->setEnabled(true);
m_pStopAutoUpdateButton->setEnabled(false);

// Ajout des éléments de l'interface opérateur à la mise en page du dialogue
// Et application de cette mise en page au dialogue
m_pHLayout->addWidget(m_pEditButton);
m_pHLayout->addStretch();
m_pHLayout->addWidget(m_pStartAutoUpdateButton);
m_pHLayout->addWidget(m_pStopAutoUpdateButton);
m_pVLayout->addWidget(m_pDT);
m_pVLayout->addLayout(m_pHLayout);
setLayout(m_pVLayout);

// Connections signaux <--> slots
connect(m_pEditButton, SIGNAL(clicked()), this, SLOT(OnEdit()));
connect(m_pStartAutoUpdateButton, SIGNAL(clicked()), this, SLOT(OnStartAutoUpdate()));
connect(m_pStopAutoUpdateButton, SIGNAL(clicked()), this, SLOT(OnStopAutoUpdate()));
}

Dialog::~Dialog()
{
}

void Dialog::OnStartAutoUpdate()
{
// Si on peut passer en mode auto update on modifie la validité des boutons start et stop
// La fonction StartAutoUpdate retourne false si le datetime est en mode édition
if(m_pDT->StartAutoUpdate())
{
m_pStartAutoUpdateButton->setEnabled(false);
m_pStopAutoUpdateButton->setEnabled(true);
}
}

void Dialog::OnStopAutoUpdate()
{
// Arrêt du mode auto update et activation/désactivation des boutons start et stop
m_pDT->StopAutoUpdate();
m_pStartAutoUpdateButton->setEnabled(true);
m_pStopAutoUpdateButton->setEnabled(false);
}

void Dialog::OnEdit()
{
// On inverse simplement la propriété CanEdit
// Le TDateTime autorise cela même en mode auto update
// Il est donc bon de vérifier si le mode auto update est actif avant de modifier cette propriété
if(!m_pStartAutoUpdateButton->isEnabled()) return;
m_pDT->SetCanEdit(!m_pDT->GetCanEdit());
}

Présentation du fonctionnement

La classe TDateTime est étroitement liée à la classe QDateTime de Qt. Elle permet d'afficher ou de modifier la valeur d'un objet de la classe QDateTime.

Un objet de la classe TDateTime peut fonctionner selon deux modes différents selon le contenu de la propriété CanEdit. Si celle-ci est réglée à la valeur false, l'objet se comporte comme un simple afficheur. La valeur affichée peut être modifiée soit en modifiant le contenu de la propriété Value via l'une des méthodes de réglage de la date et heure comme, à titre d'exxemple : SetDate, SetTime, AddHours, etc..., soit en activant la mise à jour automatique via un appel à la méthode StartAutoUpdate. Dans ce cas l'objet affiche la date et l'heure courante ainsi que tous les paramètres s'y rattachant (Jour de l'année, semaine de l'année, AM/PM, Décalage par rapport à l'heure UTC).

Lorsque la propriété CanEdit est réglée sur true, l'objet affiche des icones d'incrémentation et décrémentation de tous les composants permettant de modifier une date ou une heure.

Relations d'héritage

- Hérite de :
- TWidget.

Fonctions publiques

	TDateTime(QWidget *parent = nullptr)
bool	AddDays(const int& Days)
bool	AddHours(const int& Hours)
bool	AddMilliSeconds(const int& MilliSeconds)
bool	AddMinutes(const int& Minutes)
bool	AddMonths(const int& Months)
bool	AddSeconds(const int& Seconds)
bool	AddYears(const int& Years)
void	void Copy(TDateTime* pTarget)
TDateTime*	CreateCopy(QWidget *parent = nullptr)
qint64*	GetDaysTo(const QDateTime& DateTime, bool* Tf = NULL))
qint64*	GetMilliSecondsTo(const QDateTime& DateTime, bool* Tf = NULL))
qint64*	GetSecondsTo(const QDateTime& DateTime, bool* Tf = NULL))
QUuid	GetTWidgetIdentifier()
QString	GetTWidgetIdentifierAsString()
QString	GetTWidgetName()
bool	IsAfter(const QDateTime& DateTime, bool* Tf = NULL)
bool	IsBefore(const QDateTime& DateTime, bool* Tf = NULL)
bool	IsEqual(const QDateTime& DateTime, bool* Tf = NULL)
bool	SetDate(const int& Day, const int& Month, const int& Year)
bool	SetTime(const int& Hour, const int& Minute, const int& Second, const int& MilliSecond)
bool	SetValueFromRTC()
bool	SetValueFromSecondsSince1970(const uint& Seconds)
bool	StartAutoUpdate()
void	StopAutoUpdate()

Signaux publiques

void

Updated()

Propriétés unqiuement accessibles en lecture

Propriétés	Type	Lecture
AmPm	TXS::AMPM	AmPm()
Date	QDate	Date()
DateValueAsString	QString	DateValueAsString()
Day	int	Day()
DayOfWeek	int	DayOfWeek()
DayOfYear	int	DayOfYear()
Hour	int	Hour()
IsLeapYear	bool	IsLeapYear()
IsValid	bool	IsValid()
MilliSecond	int	MilliSecond()
MilliSecondsSince1970	qint64	MilliSecondsSince1970()
Minute	int	Minute()
Month	int	Month()
Second	int	Second()
SecondsSince1970	uint	SecondsSince1970()
Time	QTime	Time()
TimeValueAsString	QString	TimeValueAsString()
ValueAsString	QString	ValueAsString()
WeekNumber	int	WeekNumber()
Year	int	Year()

Propriétés

Propriétés	Type	Ecriture	Lecture
AmPmFlagVisible	bool	SetAmPmFlagVisible	GetAmPmFlagVisible
AutoSizeFonts	bool	SetAutoSizeFonts	GetAutoSizeFonts
BordersColor	QColor	SetBordersColor	GetBordersColor
BordersColorInvalid	QColor	SetBordersColorInvalid	GetBordersColorInvalid
BordersWidths	int	SetBordersWidths	GetBordersWidths
CanEdit	bool	SetCanEdit	GetCanEdit
DateAlignment	TXS::HrzAlignment	SetDateAlignment	GetDateAlignment
DateBackgroundColor	QColor	SetDateBackgroundColor	GetDateBackgroundColor
DateBorderVisible	bool	SetDateBorderVisible	GetDateBorderVisible
DateFont	QFont	SetDateFont	GetDateFont
DateFormat	TXS::DateOnlyFormat	SetDateFormat	GetDateFormat
DateTextColor	QColor	SetDateTextColor	GetDateTextColor
DateTimeFormat	TXS::TimeFormat	SetDateTimeFormat	GetDateTimeFormat
DateTimeSpecification	TXS::DateTimeSpecification	SetDateTimeSpecification	GetDateTimeSpecification
DateTimeVerticalMarginHeight	int	SetDateTimeVerticalMarginHeight	GetDateTimeVerticalMarginHeight
DateVisible	bool	SetDateVisible	GetDateVisible
DayOfYearFlagVisible	bool	SetDayOfYearFlagVisible	GetDayOfYearFlagVisible
FlagsBackgroundColor	QColor	SetFlagsBackgroundColor	GetFlagsBackgroundColor
FlagsBordersVisible	bool	SetFlagsBordersVisible	GetFlagsBordersVisible
FlagsFont	QFont	SetFlagsFont	GetFlagsFont
FlagsHorizontalMarginWidth	int	SetFlagsHorizontalMarginWidth	GetFlagsHorizontalMarginWidth
FlagsTextColor	QColor	SetFlagsTextColor	GetFlagsTextColor
FlagsVerticalMarginHeight	int	SetFlagsVerticalMarginHeight	GetFlagsVerticalMarginHeight
TimeAlignment	TXS::HrzAlignment	SetTimeAlignment	GetTimeAlignment
TimeBackgroundColor	QColor	SetTimeBackgroundColor	GetTimeBackgroundColor
TimeBorderVisible	bool	SetTimeBorderVisible	GetTimeBorderVisible
TimeFont	QFont	SetTimeFont	GetTimeFont
TimeFormat	TXS::TimeOnlyFormat	SetTimeFormat	GetTimeFormat
TimeTextColor	QColor	SetTimeTextColor	GetTimeTextColor
TimeVisible	bool	SetTimeVisible	GetTimeVisible
TimeZone	TXS::TimeZone	SetTimeZone	GetTimeZone
TimeZoneFlagVisible	bool	SetTimeZoneFlagVisible	GetTimeZoneFlagVisible
UseDaysNames	bool	SetUseDaysNames	GetUseDaysNames
UseLongNames	bool	SetUseLongNames	GetUseLongNames
UseMonthsNames	bool	SetUseMonthsNames	GetUseMonthsNames
UTCDiffFlagVisible	bool	SetUTCDiffFlagVisible	GetUTCDiffFlagVisible
Value	QDateTime	SetValue	Value
WeekNumberFlagVisible	bool	SetWeekNumberFlagVisible	GetWeekNumberFlagVisible

TDateTime::TDateTime(QWidget *parent = nullptr)

Description : Contructeur. Instancie un objet de la classe TDateTime.

Paramètre : parent - type QWidget* - Pointeur vers un QWidget parent s'il existe. Ce paramètre est optionnel

bool TDateTime::AddDays(const int& Days)

Description : Ajoute ou soustrait (dans le cas ou le paramètre Days est négatif) un nombre de jours à la propriété Value et met à jour l'affichage.

Paramètre : Days - type int& - Nombre de jours à ajouter ou soustraire.