QDateTimeEdit Class
La classe QDateTimeEdit fournit un widget permettant de modifier les dates et les heures. Plus d'informations...
| En-tête : | #include <QDateTimeEdit> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite : | QAbstractSpinBox |
| Héritée par : |
Types publics
| enum | Section { NoSection, AmPmSection, MSecSection, SecondSection, MinuteSection, …, YearSection } |
| flags | Sections |
Propriétés
|
|
Fonctions publiques
| QDateTimeEdit(QWidget *parent = nullptr) | |
| QDateTimeEdit(QDate date, QWidget *parent = nullptr) | |
| QDateTimeEdit(QTime time, QWidget *parent = nullptr) | |
| QDateTimeEdit(const QDateTime &datetime, QWidget *parent = nullptr) | |
| virtual | ~QDateTimeEdit() |
| QCalendar | calendar() const |
| bool | calendarPopup() const |
| QCalendarWidget * | calendarWidget() const |
| void | clearMaximumDate() |
| void | clearMaximumDateTime() |
| void | clearMaximumTime() |
| void | clearMinimumDate() |
| void | clearMinimumDateTime() |
| void | clearMinimumTime() |
| QDateTimeEdit::Section | currentSection() const |
| int | currentSectionIndex() const |
| QDate | date() const |
| QDateTime | dateTime() const |
| QString | displayFormat() const |
| QDateTimeEdit::Sections | displayedSections() const |
| QDate | maximumDate() const |
| QDateTime | maximumDateTime() const |
| QTime | maximumTime() const |
| QDate | minimumDate() const |
| QDateTime | minimumDateTime() const |
| QTime | minimumTime() const |
| QDateTimeEdit::Section | sectionAt(int index) const |
| int | sectionCount() const |
| QString | sectionText(QDateTimeEdit::Section section) const |
| void | setCalendar(QCalendar calendar) |
| void | setCalendarPopup(bool enable) |
| void | setCalendarWidget(QCalendarWidget *calendarWidget) |
| void | setCurrentSection(QDateTimeEdit::Section section) |
| void | setCurrentSectionIndex(int index) |
| void | setDateRange(QDate min, QDate max) |
| void | setDateTimeRange(const QDateTime &min, const QDateTime &max) |
| void | setDisplayFormat(const QString &format) |
| void | setMaximumDate(QDate max) |
| void | setMaximumDateTime(const QDateTime &dt) |
| void | setMaximumTime(QTime max) |
| void | setMinimumDate(QDate min) |
| void | setMinimumDateTime(const QDateTime &dt) |
| void | setMinimumTime(QTime min) |
| void | setSelectedSection(QDateTimeEdit::Section section) |
| void | setTimeRange(QTime min, QTime max) |
| void | setTimeZone(const QTimeZone &zone) |
| QTime | time() const |
| QTimeZone | timeZone() const |
Fonctions publiques réimplémentées
| virtual void | clear() override |
| virtual bool | event(QEvent *event) override |
| virtual QSize | sizeHint() const override |
| virtual void | stepBy(int steps) override |
Emplacements publics
| void | setDate(QDate date) |
| void | setDateTime(const QDateTime &dateTime) |
| void | setTime(QTime time) |
Signaux
| void | dateChanged(QDate date) |
| void | dateTimeChanged(const QDateTime &datetime) |
| void | timeChanged(QTime time) |
Fonctions protégées
| virtual QDateTime | dateTimeFromText(const QString &text) const |
| virtual QString | textFromDateTime(const QDateTime &dateTime) const |
Fonctions protégées réimplémentées
| virtual void | fixup(QString &input) const override |
| virtual void | focusInEvent(QFocusEvent *event) override |
| virtual bool | focusNextPrevChild(bool next) override |
| virtual void | initStyleOption(QStyleOptionSpinBox *option) const override |
| virtual void | keyPressEvent(QKeyEvent *event) override |
| virtual void | mousePressEvent(QMouseEvent *event) override |
| virtual void | paintEvent(QPaintEvent *event) override |
| virtual QAbstractSpinBox::StepEnabled | stepEnabled() const override |
| virtual QValidator::State | validate(QString &text, int &pos) const override |
| virtual void | wheelEvent(QWheelEvent *event) override |
Description détaillée
QDateTimeEdit permet à l'utilisateur de modifier des dates en utilisant le clavier ou les touches fléchées pour augmenter et diminuer les valeurs de la date et de l'heure. Les touches fléchées peuvent être utilisées pour passer d'une section à l'autre dans la boîte de QDateTimeEdit. Les dates et les heures apparaissent conformément au format défini ; voir setDisplayFormat().
QDateTimeEdit *dateEdit = new QDateTimeEdit(QDate::currentDate()); dateEdit->setMinimumDate(QDate::currentDate().addDays(-365)); dateEdit->setMaximumDate(QDate::currentDate().addDays(365)); dateEdit->setDisplayFormat("yyyy.MM.dd");
Ici, nous avons créé un nouvel objet QDateTimeEdit initialisé avec la date d'aujourd'hui et limité la plage de dates valides à aujourd'hui plus ou moins 365 jours. L'ordre est le suivant : mois, jour, année.
La plage de valeurs valides pour un QDateTimeEdit est contrôlée par les propriétés minimumDateTime, maximumDateTime, et leurs composants de date et d'heure respectifs. Par défaut, toute date-heure comprise entre le début de l'année 100 CE et la fin de l'année 9999 CE est valide.
Utilisation d'un widget de calendrier contextuel
QDateTimeEdit peut être configuré pour permettre l'utilisation d'un QCalendarWidget pour sélectionner les dates. Cette fonction est activée en définissant la propriété calendarPopup. En outre, vous pouvez fournir un widget de calendrier personnalisé à utiliser comme fenêtre contextuelle de calendrier en appelant la fonction setCalendarWidget(). Le widget de calendrier existant peut être récupéré à l'aide de la fonction calendarWidget().
Suivi du clavier
Lorsque keyboard tracking est activé (par défaut), chaque frappe au clavier lors de l'édition d'un champ déclenche des signaux de changement de valeur.
Lorsque la plage autorisée range est plus étroite qu'un intervalle de temps dont elle chevauche la fin, le suivi du clavier empêche l'utilisateur de modifier la date ou l'heure pour accéder à la dernière partie de l'intervalle. Par exemple, pour un intervalle allant du 29.04.2020 au 02.05.2020 et une date initiale du 30.04.2020, l'utilisateur ne peut modifier ni le mois (le 30 mai est en dehors de l'intervalle) ni le jour (le 2 avril est en dehors de l'intervalle).
Lorsque le suivi du clavier est désactivé, les modifications ne sont signalées que lorsque le curseur quitte le champ de texte après que le contenu a été modifié. Cela permet à l'utilisateur de modifier une date et une heure non valides pour atteindre une date et une heure valides.
Voir également QDateEdit, QTimeEdit, QDate, et QTime.
Documentation sur les types de membres
enum QDateTimeEdit::Section
flags QDateTimeEdit::Sections
| Constante | Valeur |
|---|---|
QDateTimeEdit::NoSection | 0x0000 |
QDateTimeEdit::AmPmSection | 0x0001 |
QDateTimeEdit::MSecSection | 0x0002 |
QDateTimeEdit::SecondSection | 0x0004 |
QDateTimeEdit::MinuteSection | 0x0008 |
QDateTimeEdit::HourSection | 0x0010 |
QDateTimeEdit::DaySection | 0x0100 |
QDateTimeEdit::MonthSection | 0x0200 |
QDateTimeEdit::YearSection | 0x0400 |
Le type Sections est un typedef pour QFlags<Section>. Il stocke une combinaison OU de valeurs de section.
Documentation sur les propriétés
calendarPopup : bool
Cette propriété contient le mode d'affichage actuel de la fenêtre contextuelle du calendrier.
La fenêtre contextuelle du calendrier s'affiche lorsque l'on clique sur le bouton fléché. Cette propriété n'est valide que si le format d'affichage de la date est valide.
Fonctions d'accès :
| bool | calendarPopup() const |
| void | setCalendarPopup(bool enable) |
Voir également setDisplayFormat().
currentSection : Section
Cette propriété contient la section courante de la boîte à outils.
Fonctions d'accès :
| QDateTimeEdit::Section | currentSection() const |
| void | setCurrentSection(QDateTimeEdit::Section section) |
currentSectionIndex : int
Cette propriété contient l'index de la section courante de la boîte à outils.
Si le format est 'yyyy/MM/dd', le displayText est '2001/05/21', et le cursorPosition est 5, currentSectionIndex renvoie 1. Si la position du curseur est 3, currentSectionIndex est 0, et ainsi de suite.
Fonctions d'accès :
| int | currentSectionIndex() const |
| void | setCurrentSectionIndex(int index) |
Voir aussi setCurrentSection() et currentSection().
date : QDate
Cette propriété contient le QDate qui est défini dans le widget.
Par défaut, cette propriété contient une date qui se réfère au 1er janvier 2000.
Fonctions d'accès :
| QDate | date() const |
| void | setDate(QDate date) |
Signal Notifier :
| void | dateChanged(QDate date) |
dateTime : QDateTime
Cette propriété contient le QDateTime qui est défini dans le QDateTimeEdit.
Lors de la définition de cette propriété, le nouveau QDateTime est converti dans le système de temps du QDateTimeEdit, qui reste donc inchangé.
Par défaut, cette propriété est fixée au début de l'année 2000 CE. Elle ne peut être fixée qu'à une valeur valide de QDateTime. Si une opération quelconque fait que cette propriété a une date-heure non valide comme valeur, elle est réinitialisée à la valeur de la propriété minimumDateTime.
Si le site QDateTimeEdit n'a pas de champs de date, la définition de cette propriété permet de définir la plage de dates du widget comme commençant et se terminant à la date de la nouvelle valeur de cette propriété.
Fonctions d'accès :
| QDateTime | dateTime() const |
| void | setDateTime(const QDateTime &dateTime) |
Notifier signal :
| void | dateTimeChanged(const QDateTime &datetime) |
Voir aussi date, time, minimumDateTime, maximumDateTime, et timeZone.
displayFormat : QString
Cette propriété définit le format utilisé pour afficher l'heure et la date de l'édition de la date et de l'heure.
Ce format est décrit dans QDateTime::toString() et QDateTime::fromString().
Exemple de chaînes de format (en supposant que la date est le 2 juillet 1969) :
| Format | Résultat |
|---|---|
| dd.MM.yyyy | 02.07.1969 |
| MMM j yy | 2 juillet 69 |
| MMMM j yy | 2 juillet 69 |
Notez que si vous spécifiez une année à deux chiffres, elle sera interprétée comme faisant partie du siècle dans lequel l'édition de la date et de l'heure a été initialisée. Le siècle par défaut est le 21e (2000-2099).
Si vous spécifiez un format non valide, le format ne sera pas défini.
Fonctions d'accès :
| QString | displayFormat() const |
| void | setDisplayFormat(const QString &format) |
Voir aussi QDateTime::toString() et displayedSections().
[read-only] displayedSections : Sections
Cette propriété contient les champs actuellement affichés de l'édition de la date et de l'heure.
Renvoie un jeu de bits des sections affichées pour ce format.
Fonctions d'accès :
| QDateTimeEdit::Sections | displayedSections() const |
Voir aussi setDisplayFormat() et displayFormat().
maximumDate : QDate
Cette propriété contient la date maximale de l'édition de la date et de l'heure.
La modification de cette propriété met à jour la date de la propriété maximumDateTime tout en préservant la propriété maximumTime. Lors de la définition de cette propriété, la propriété minimumDate est ajustée, si nécessaire, pour s'assurer que la plage reste valide. Dans ce cas, la propriété minimumTime est également ajustée si elle est supérieure à la propriété maximumTime. Dans le cas contraire, les modifications apportées à cette propriété préservent la propriété minimumDateTime.
Cette propriété ne peut être définie que pour un objet QDate valide décrivant une date à laquelle la propriété maximumTime actuelle correspond à un objet QDateTime valide. La date la plus tardive acceptée par setMaximumDate() est la fin de l'année 9999 CE. C'est la valeur par défaut de cette propriété. Cette valeur par défaut peut être rétablie à l'aide de clearMaximumDateTime().
Fonctions d'accès :
| QDate | maximumDate() const |
| void | setMaximumDate(QDate max) |
| void | clearMaximumDate() |
Voir aussi minimumDate, maximumTime, maximumDateTime, setDateRange(), QDate::isValid() et Keyboard Tracking.
maximumDateTime : QDateTime
Cette propriété contient la durée maximale de l'édition de la date et de l'heure.
La modification de cette propriété met implicitement à jour les propriétés maximumDate et maximumTime en fonction des parties date et heure de cette propriété, respectivement. Lors de la définition de cette propriété, la propriété minimumDateTime est ajustée, si nécessaire, pour garantir que la plage reste valide. Sinon, la modification de cette propriété préserve la propriété minimumDateTime.
Cette propriété ne peut être définie que par une valeur QDateTime valide. La dernière date-heure acceptée par setMaximumDateTime() est la fin de l'année 9999 CE. C'est la valeur par défaut de cette propriété. Cette valeur par défaut peut être rétablie avec clearMaximumDateTime().
Fonctions d'accès :
| QDateTime | maximumDateTime() const |
| void | setMaximumDateTime(const QDateTime &dt) |
| void | clearMaximumDateTime() |
Voir aussi minimumDateTime, maximumTime, maximumDate(), setDateTimeRange(), QDateTime::isValid() et Keyboard Tracking.
maximumTime : QTime
Cette propriété contient l'heure maximale de l'édition de la date et de l'heure.
La modification de cette propriété met à jour l'heure de la propriété maximumDateTime tout en préservant les propriétés minimumDate et maximumDate. Si ces propriétés de date coïncident, lors de la définition de cette propriété, la propriété minimumTime est ajustée, si nécessaire, pour s'assurer que la plage reste valide. Dans le cas contraire, la modification de cette propriété préserve la propriété minimumDateTime.
Cette propriété peut être définie sur n'importe quelle valeur valide de QTime. Par défaut, cette propriété contient une heure de 23:59:59 et 999 millisecondes. Cette valeur par défaut peut être restaurée avec clearMaximumTime().
Fonctions d'accès :
| QTime | maximumTime() const |
| void | setMaximumTime(QTime max) |
| void | clearMaximumTime() |
Voir aussi minimumTime, maximumDate, maximumDateTime, setTimeRange(), QTime::isValid() et Keyboard Tracking.
minimumDate : QDate
Cette propriété contient la date minimale de l'édition de la date et de l'heure.
La modification de cette propriété met à jour la date de la propriété minimumDateTime tout en préservant la propriété minimumTime. Lors de la définition de cette propriété, la propriété maximumDate est ajustée, si nécessaire, pour s'assurer que la plage reste valide. Dans ce cas, la propriété maximumTime est également ajustée si elle est inférieure à la propriété minimumTime. Dans le cas contraire, les modifications apportées à cette propriété préservent la propriété maximumDateTime.
Cette propriété ne peut être définie que comme un objet QDate valide décrivant une date à laquelle la propriété minimumTime actuelle correspond à un objet QDateTime valide. La date la plus ancienne acceptée par setMinimumDate() est le début de l'année 100 CE. La valeur par défaut de cette propriété est le 14 septembre 1752 de notre ère. Cette valeur par défaut peut être rétablie à l'aide de clearMinimumDateTime().
Fonctions d'accès :
| QDate | minimumDate() const |
| void | setMinimumDate(QDate min) |
| void | clearMinimumDate() |
Voir aussi maximumDate, minimumTime, minimumDateTime, setDateRange(), QDate::isValid() et Keyboard Tracking.
minimumDateTime : QDateTime
Cette propriété contient la date minimale de l'édition de la date et de l'heure.
La modification de cette propriété met implicitement à jour les propriétés minimumDate et minimumTime avec les parties date et heure de cette propriété, respectivement. Lors de la définition de cette propriété, la propriété maximumDateTime est ajustée, si nécessaire, pour s'assurer que la plage reste valide. Sinon, la modification de cette propriété préserve la propriété maximumDateTime.
Cette propriété ne peut être définie que par une valeur valide de QDateTime. La date-heure la plus ancienne acceptée par setMinimumDateTime() est le début de l'année 100 CE. La valeur par défaut de la propriété est le début du 14 septembre 1752 de notre ère. Cette valeur par défaut peut être rétablie avec clearMinimumDateTime().
Fonctions d'accès :
| QDateTime | minimumDateTime() const |
| void | setMinimumDateTime(const QDateTime &dt) |
| void | clearMinimumDateTime() |
Voir aussi maximumDateTime, minimumTime, minimumDate, setDateTimeRange(), QDateTime::isValid() et Keyboard Tracking.
minimumTime : QTime
Cette propriété contient l'heure minimale de l'édition de la date et de l'heure.
La modification de cette propriété met à jour l'heure de la propriété minimumDateTime tout en préservant les propriétés minimumDate et maximumDate. Si ces propriétés de date coïncident, lors de la définition de cette propriété, la propriété maximumTime est ajustée, si nécessaire, pour s'assurer que la plage reste valide. Dans le cas contraire, la modification de cette propriété préserve la propriété maximumDateTime.
Cette propriété peut être définie sur n'importe quelle valeur valide de QTime. Par défaut, cette propriété contient une heure de 00:00:00 et 0 milliseconde. Cette valeur par défaut peut être restaurée avec clearMinimumTime().
Fonctions d'accès :
| QTime | minimumTime() const |
| void | setMinimumTime(QTime min) |
| void | clearMinimumTime() |
Voir aussi maximumTime, minimumDate, minimumDateTime, setTimeRange(), QTime::isValid() et Keyboard Tracking.
[read-only] sectionCount : int
Cette propriété indique le nombre de sections affichées. Si le format est 'yyyy/yyyy/yyyyyy', sectionCount renvoie 3
Fonctions d'accès :
| int | sectionCount() const |
time : QTime
Cette propriété contient le QTime qui est défini dans le widget.
Par défaut, cette propriété contient une heure de 00:00:00 et 0 milliseconde.
Fonctions d'accès :
| QTime | time() const |
| void | setTime(QTime time) |
Signal du notificateur :
| void | timeChanged(QTime time) |
[since 6.7] timeZone : QTimeZone
Cette propriété contient le fuseau horaire utilisé par le widget d'édition de l'heure de la date
Si le format de date utilisé comprend un indicateur de fuseau horaire - c'est-à-dire un spécificateur de format t, tt, ttt ou tttt - la saisie de l'utilisateur est ré-exprimée dans ce fuseau horaire à chaque fois qu'elle est analysée, en remplaçant tout fuseau horaire que l'utilisateur peut avoir spécifié.
Cette propriété a été introduite dans Qt 6.7.
Fonctions d'accès :
| QTimeZone | timeZone() const |
| void | setTimeZone(const QTimeZone &zone) |
Voir aussi QDateTimeEdit::displayFormat.
Documentation sur les fonctions membres
[explicit] QDateTimeEdit::QDateTimeEdit(QWidget *parent = nullptr)
Construit un éditeur de date et d'heure vide avec une adresse parent.
[explicit] QDateTimeEdit::QDateTimeEdit(QDate date, QWidget *parent = nullptr)
Construit un éditeur de date et d'heure vide avec une valeur parent. La valeur est fixée à date.
[explicit] QDateTimeEdit::QDateTimeEdit(QTime time, QWidget *parent = nullptr)
Construit un éditeur de date et d'heure vide avec une valeur parent. La valeur est fixée à time.
[explicit] QDateTimeEdit::QDateTimeEdit(const QDateTime &datetime, QWidget *parent = nullptr)
Construit un éditeur de date et d'heure vide avec une valeur parent. La valeur est fixée à datetime.
[virtual noexcept] QDateTimeEdit::~QDateTimeEdit()
Destructeur.
QCalendar QDateTimeEdit::calendar() const
Indique le système de calendrier utilisé par ce widget.
Voir aussi setCalendar().
QCalendarWidget *QDateTimeEdit::calendarWidget() const
Renvoie le widget de calendrier de l'éditeur si calendarPopup a la valeur true et si (sections() & DateSections_Mask) != 0.
Cette fonction crée et renvoie un widget de calendrier si aucun n'a été défini.
Voir aussi setCalendarWidget().
[override virtual] void QDateTimeEdit::clear()
Réimplémente : QAbstractSpinBox::clear().
QDate QDateTimeEdit::date() const
Renvoie la date de l'édition de la date et de l'heure.
Note : Fonction Getter pour la propriété date.
Voir aussi setDate().
[signal] void QDateTimeEdit::dateChanged(QDate date)
Ce signal est émis lorsque la date est modifiée. La nouvelle date est transmise à date.
Note : Signal de notification pour la propriété date.
Voir aussi Keyboard Tracking.
[signal] void QDateTimeEdit::dateTimeChanged(const QDateTime &datetime)
Ce signal est émis lorsque la date ou l'heure est modifiée. La nouvelle date et la nouvelle heure sont transmises à datetime.
Note : Signal de notification pour la propriété dateTime.
Voir aussi Keyboard Tracking.
[virtual protected] QDateTime QDateTimeEdit::dateTimeFromText(const QString &text) const
Renvoie une date appropriée pour l'adresse text.
Cette fonction virtuelle est utilisée par l'éditeur datetime chaque fois qu'il doit interpréter le texte saisi par l'utilisateur comme une valeur.
Voir aussi textFromDateTime() et validate().
[override virtual] bool QDateTimeEdit::event(QEvent *event)
Réimplémente : QAbstractSpinBox::event(QEvent *event).
[override virtual protected] void QDateTimeEdit::fixup(QString &input) const
Réimplémente : QAbstractSpinBox::fixup(QString &input) const.
[override virtual protected] void QDateTimeEdit::focusInEvent(QFocusEvent *event)
Réimplémente : QAbstractSpinBox::focusInEvent(QFocusEvent *event).
[override virtual protected] bool QDateTimeEdit::focusNextPrevChild(bool next)
Réimplémente : QWidget::focusNextPrevChild(bool next).
[override virtual protected] void QDateTimeEdit::initStyleOption(QStyleOptionSpinBox *option) const
Réimplémente : QAbstractSpinBox::initStyleOption(QStyleOptionSpinBox *option) const.
Initialise option avec les valeurs de ce QDataTimeEdit. Cette méthode est utile pour les sous-classes qui ont besoin d'un QStyleOptionSpinBox, mais qui ne veulent pas remplir toutes les informations elles-mêmes.
Voir aussi QStyleOption::initFrom().
[override virtual protected] void QDateTimeEdit::keyPressEvent(QKeyEvent *event)
Réimplémente : QAbstractSpinBox::keyPressEvent(QKeyEvent *event).
[override virtual protected] void QDateTimeEdit::mousePressEvent(QMouseEvent *event)
Réimplémente : QAbstractSpinBox::mousePressEvent(QMouseEvent *event).
[override virtual protected] void QDateTimeEdit::paintEvent(QPaintEvent *event)
Réimplémente : QAbstractSpinBox::paintEvent(QPaintEvent *event).
QDateTimeEdit::Section QDateTimeEdit::sectionAt(int index) const
Renvoie la section à index.
Si le format est "aaaa/MM/jj", sectionAt(0) renvoie YearSection, sectionAt(1) renvoie MonthSection, et sectionAt(2) renvoie YearSection,
QString QDateTimeEdit::sectionText(QDateTimeEdit::Section section) const
Renvoie le texte de l'adresse section.
Voir aussi currentSection().
void QDateTimeEdit::setCalendar(QCalendar calendar)
Définit calendar comme le système de calendrier à utiliser par ce widget.
Le widget peut utiliser n'importe quel système de calendrier pris en charge. Par défaut, il utilise le calendrier grégorien.
Voir aussi calendar().
void QDateTimeEdit::setCalendarWidget(QCalendarWidget *calendarWidget)
Définit le widget calendarWidget comme widget à utiliser pour la fenêtre contextuelle du calendrier. L'éditeur ne prend pas automatiquement possession du widget de calendrier.
Remarque : calendarPopup doit avoir la valeur true avant de définir le widget de calendrier.
Voir aussi calendarWidget() et calendarPopup.
void QDateTimeEdit::setDateRange(QDate min, QDate max)
Définit la plage de dates autorisées pour l'édition de la date et de l'heure.
Cette fonction de commodité définit les propriétés minimumDate et maximumDate.
setDateRange(min, max);est analogue à :
setMinimumDate(min); setMaximumDate(max);
Si min ou max n'est pas valide, cette fonction ne fait rien. Cette fonction préserve la propriété minimumTime. Si max est inférieur à min, la nouvelle propriété maximumDateTime sera la nouvelle propriété minimumDateTime. Si max est égal à min et que la propriété maximumTime était inférieure à la propriété minimumTime, la propriété maximumTime est remplacée par la propriété minimumTime. Dans le cas contraire, la propriété maximumTime est conservée.
Si l'intervalle est plus étroit qu'un intervalle de temps dont il couvre la fin, par exemple une semaine qui couvre la fin d'un mois, les utilisateurs ne peuvent modifier la date que dans la dernière partie de l'intervalle si le suivi du clavier est désactivé.
Voir également minimumDate, maximumDate, setDateTimeRange(), QDate::isValid() et Keyboard Tracking.
void QDateTimeEdit::setDateTimeRange(const QDateTime &min, const QDateTime &max)
Définit la plage de dates-heure autorisées pour l'édition de la date et de l'heure.
Cette fonction de commodité définit les propriétés minimumDateTime et maximumDateTime.
setDateTimeRange(min, max);est analogue à :
setMinimumDateTime(min); setMaximumDateTime(max);
Si min ou max n'est pas valide, cette fonction ne fait rien. Si max est inférieur à min, min est également utilisé comme max.
Si l'intervalle est plus étroit qu'un intervalle de temps dont il couvre la fin, par exemple une semaine qui couvre la fin d'un mois, les utilisateurs ne peuvent modifier la date et l'heure que dans la dernière partie de l'intervalle si le suivi du clavier est désactivé.
Voir aussi minimumDateTime, maximumDateTime, setDateRange(), setTimeRange(), QDateTime::isValid(), et Keyboard Tracking.
void QDateTimeEdit::setSelectedSection(QDateTimeEdit::Section section)
Sélectionne section. Si section n'existe pas dans les sections actuellement affichées, cette fonction ne fait rien. Si section est NoSection, cette fonction désélectionne tout le texte dans l'éditeur. Sinon, cette fonction déplace le curseur et la section en cours vers la section sélectionnée.
Voir également currentSection().
void QDateTimeEdit::setTimeRange(QTime min, QTime max)
Définit la plage de temps autorisée pour l'édition de la date et de l'heure.
Cette fonction de commodité définit les propriétés minimumTime et maximumTime.
Notez que celles-ci ne contraignent la valeur de l'édition de la date et de l'heure que sur, respectivement, les propriétés minimumDate et maximumDate. Lorsque ces propriétés de date ne coïncident pas, les heures après max sont autorisées pour les dates avant maximumDate et les heures avant min sont autorisées pour les dates après minimumDate.
setTimeRange(min, max);est analogue à :
setMinimumTime(min); setMaximumTime(max);
Si min ou max est invalide, cette fonction ne fait rien. Cette fonction préserve les propriétés minimumDate et maximumDate. Si ces propriétés coïncident et que max est inférieur à min, min est utilisé comme max.
Si l'intervalle est plus étroit qu'un intervalle de temps dont il couvre la fin, par exemple l'intervalle de dix heures moins une heure à dix heures plus une heure, les utilisateurs ne peuvent modifier l'heure à une heure dans la dernière partie de l'intervalle que si le suivi du clavier est désactivé.
Voir également minimumTime, maximumTime, setDateTimeRange(), QTime::isValid() et Keyboard Tracking.
[override virtual] QSize QDateTimeEdit::sizeHint() const
Réimplémente : QAbstractSpinBox::sizeHint() const.
[override virtual] void QDateTimeEdit::stepBy(int steps)
Réimplémente : QAbstractSpinBox::stepBy(int steps).
[override virtual protected] QAbstractSpinBox::StepEnabled QDateTimeEdit::stepEnabled() const
Réimplémente : QAbstractSpinBox::stepEnabled() const.
[virtual protected] QString QDateTimeEdit::textFromDateTime(const QDateTime &dateTime) const
Cette fonction virtuelle est utilisée par l'éditeur de date et d'heure chaque fois qu'il doit afficher dateTime.
Si vous réimplémentez cette fonction, vous devrez peut-être aussi réimplémenter validate().
Voir aussi dateTimeFromText() et validate().
QTime QDateTimeEdit::time() const
Renvoie l'heure de l'édition de la date et de l'heure.
Note : Fonction Getter pour la propriété time.
Voir aussi setTime().
[signal] void QDateTimeEdit::timeChanged(QTime time)
Ce signal est émis chaque fois que l'heure est modifiée. La nouvelle heure est transmise à time.
Note : Signal de notification pour la propriété time.
Voir également Keyboard Tracking.
[override virtual protected] QValidator::State QDateTimeEdit::validate(QString &text, int &pos) const
Réimplémente : QAbstractSpinBox::validate(QString &input, int &pos) const.
[override virtual protected] void QDateTimeEdit::wheelEvent(QWheelEvent *event)
Réimplémente : QAbstractSpinBox::wheelEvent(QWheelEvent *event).
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
