QDateTimeEdit Class
La classe QDateTimeEdit fournit un widget permettant de modifier les dates et les heures. En savoir plus...
| En-tête : | #include <QDateTimeEdit> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | QAbstractSpinBox |
| Hérité 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 |
Slots 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 les dates à l'aide du clavier ou des touches fléchées pour augmenter ou diminuer les valeurs de date et d'heure. Les touches fléchées peuvent être utilisées pour se déplacer d'une section à l'autre au sein de la zone QDateTimeEdit. Les dates et heures s'affichent selon le 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 du jour, et nous avons limité la plage de dates valides à la date du jour plus ou moins 365 jours. Nous avons défini l'ordre d'affichage comme suit : mois, jour, année.
La plage des valeurs valides pour un QDateTimeEdit est contrôlée par les propriétés minimumDateTime, maximumDateTime, ainsi que par leurs composants respectifs de date et d’heure. Par défaut, toute date-heure comprise entre le début de l’an 100 et la fin de l’an 9999 est valide.
Utilisation d’un widget de calendrier contextuel
QDateTimeEdit peut être configuré pour permettre l’utilisation d’un QCalendarWidget afin de sélectionner des dates. Cette fonctionnalité est activée en définissant la propriété calendarPopup. De plus, vous pouvez fournir un widget de calendrier personnalisé à utiliser comme calendrier contextuel en appelant la fonction setCalendarWidget(). Le widget de calendrier existant peut être récupéré avec calendarWidget().
Suivi du clavier
Lorsque l’option « keyboard tracking » est activée (par défaut), chaque frappe effectuée lors de la modification d’un champ déclenche des signaux indiquant un changement de valeur.
Lorsque la plage de dates autorisée ( range ) est plus étroite qu’un certain 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 partie postérieure de l’intervalle. Par exemple, pour une plage 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 se trouve en dehors de la plage) ni le jour (le 2 avril se trouve en dehors de la plage).
Lorsque le verrouillage du clavier est désactivé, les modifications ne sont signalées que lorsque le focus quitte le champ de texte après que des modifications ont altéré le contenu. Cela permet à l’utilisateur de passer par une date-heure non valide pour atteindre une date-heure valide.
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 Section.
Documentation de la propriété
calendarPopup : bool
Cette propriété définit 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 valable que s'il existe un format d'affichage de date valide.
Fonctions d'accès :
| bool | calendarPopup() const |
| void | setCalendarPopup(bool enable) |
Voir également setDisplayFormat().
currentSection : Section
Cette propriété contient la section actuelle de la zone de saisie à rouleau.
Fonctions d'accès :
| QDateTimeEdit::Section | currentSection() const |
| void | setCurrentSection(QDateTimeEdit::Section section) |
currentSectionIndex : int
Cette propriété contient l'index de section actuel de la zone de saisie à rouleau.
Si le format est « aaaa/MM/jj », que le texte affiché (displayText) est « 2001/05/21 » et que la position du curseur (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 également setCurrentSection() et currentSection().
date : QDate
Cette propriété contient l'QDate t définie dans le widget.
Par défaut, cette propriété contient une date correspondant au 1er janvier 2000.
Fonctions d'accès :
| QDate | date() const |
| void | setDate(QDate date) |
Signal de notification :
| void | dateChanged(QDate date) |
Voir également « time » et « dateTime ».
dateTime : QDateTime
Cette propriété contient l'QDateTime définie dans l'QDateTimeEdit.
Lors de la définition de cette propriété, la nouvelle QDateTime est convertie selon le système de temps de l'QDateTimeEdit, qui reste donc inchangé.
Par défaut, cette propriété est définie sur le début de l’année 2000 de notre ère. Elle ne peut être définie que sur une valeur d’ QDateTime valide. Si une opération quelconque fait que cette propriété prend pour valeur une date-heure non valide, elle est réinitialisée à la valeur de la propriété minimumDateTime.
Si l’ QDateTimeEdit ne comporte aucun champ de date, la définition de cette propriété définit la plage de dates du widget de manière à ce qu’elle commence et se termine à la date correspondant à la nouvelle valeur de cette propriété.
Fonctions d’accès :
| QDateTime | dateTime() const |
| void | setDateTime(const QDateTime &dateTime) |
Signal de notification :
| void | dateTimeChanged(const QDateTime &datetime) |
Voir également date, time, minimumDateTime, maximumDateTime et timeZone.
displayFormat : QString
Cette propriété définit le format utilisé pour afficher l'heure et la date dans le champ de saisie date-heure.
Ce format est décrit dans QDateTime::toString() et QDateTime::fromString()
Exemples de chaînes de format (en supposant que la date soit le 2 juillet 1969) :
| Format | Résultat |
|---|---|
| jj.MM.aaaa | 02.07.1969 |
| MMM j aaa | 2 juil. 69 |
| MMMM j aaa | 2 juillet 69 |
Notez que si vous indiquez une année à deux chiffres, celle-ci sera interprétée comme appartenant au siècle au cours duquel le champ de saisie de la date et de l'heure a été initialisé. Le siècle par défaut est le XXIe siècle (2000-2099).
Si vous spécifiez un format non valide, celui-ci ne sera pas défini.
Fonctions d'accès :
| QString | displayFormat() const |
| void | setDisplayFormat(const QString &format) |
Voir également QDateTime::toString() et displayedSections().
[read-only] displayedSections : Sections
Cette propriété contient les champs actuellement affichés dans le champ de saisie date-heure.
Renvoie un ensemble de bits correspondant aux sections affichées pour ce format.
Fonctions d'accès :
| QDateTimeEdit::Sections | displayedSections() const |
Voir également setDisplayFormat() et displayFormat().
maximumDate : QDate
Cette propriété contient la date maximale du champ de saisie date-heure.
La modification de cette propriété met à jour la date de la propriété « maximumDateTime » tout en conservant la propriété « maximumTime ». Lors de la définition de cette propriété, la propriété « minimumDate » est ajustée, si nécessaire, afin de garantir 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 ». Sinon, les modifications apportées à cette propriété conservent la propriété « minimumDateTime ».
Cette propriété ne peut être définie que sur un objet QDate valide décrivant une date à laquelle la propriété maximumTime actuelle forme un objet QDateTime valide. La date la plus récente acceptée par setMaximumDate() est la fin de l’an 9999 de notre ère. Il s’agit de 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 également minimumDate, maximumTime, maximumDateTime, setDateRange(), QDate::isValid() et Keyboard Tracking.
maximumDateTime : QDateTime
Cette propriété contient la date et l'heure maximales de la modification de la date et de l'heure.
La modification de cette propriété met implicitement à jour les propriétés « maximumDate » et « maximumTime » avec respectivement la date et l’heure de cette propriété. Lors de la définition de cette propriété, la propriété « minimumDateTime » est ajustée, si nécessaire, afin de garantir que la plage reste valide. Sinon, la modification de cette propriété conserve la valeur de la propriété « minimumDateTime ».
Cette propriété ne peut être définie que sur une valeur QDateTime valide. La date-heure la plus récente acceptée par setMaximumDateTime() correspond à la fin de l'an 9999 de notre ère. Il s'agit de 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 :
| QDateTime | maximumDateTime() const |
| void | setMaximumDateTime(const QDateTime &dt) |
| void | clearMaximumDateTime() |
Voir également minimumDateTime, maximumTime, maximumDate(), setDateTimeRange(), QDateTime::isValid() et Keyboard Tracking.
maximumTime : QTime
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 à jour l'heure de la propriété « maximumDateTime » tout en conservant 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 garantir que la plage reste valide. Sinon, la modification de cette propriété conserve la propriété « minimumDateTime ».
Cette propriété peut être définie sur n’importe quelle valeur valide de type « QTime ». Par défaut, cette propriété contient une heure de 23 h 59 min 59 s et 999 millisecondes. Cette valeur par défaut peut être rétablie à l’aide de la méthode clearMaximumTime().
Fonctions d’accès :
| QTime | maximumTime() const |
| void | setMaximumTime(QTime max) |
| void | clearMaximumTime() |
Voir également minimumTime, maximumDate, maximumDateTime, setTimeRange(), QTime::isValid() et Keyboard Tracking.
minimumDate : QDate
Cette propriété contient la date minimale du champ de saisie date-heure.
La modification de cette propriété met à jour la date de la propriété « minimumDateTime » tout en conservant la propriété « minimumTime ». Lors de la définition de cette propriété, la propriété « maximumDate » est ajustée, si nécessaire, afin de garantir 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 ». Sinon, les modifications apportées à cette propriété conservent la propriété « maximumDateTime ».
Cette propriété ne peut être définie que sur un objet QDate valide décrivant une date à laquelle la propriété minimumTime actuelle forme un objet QDateTime valide. La date la plus ancienne acceptée par setMinimumDate() est le début de l’an 100 de notre ère. 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 la méthode clearMinimumDateTime().
Fonctions d'accès :
| QDate | minimumDate() const |
| void | setMinimumDate(QDate min) |
| void | clearMinimumDate() |
Voir également maximumDate, minimumTime, minimumDateTime, setDateRange(), QDate::isValid() et Keyboard Tracking.
minimumDateTime : QDateTime
Cette propriété contient la date et l'heure minimales du champ de saisie de date et d'heure.
La modification de cette propriété met implicitement à jour les propriétés « minimumDate » et « minimumTime » en leur attribuant respectivement la date et l'heure de cette propriété. Lors de la définition de cette propriété, la propriété « maximumDateTime » est ajustée, si nécessaire, afin de garantir que la plage reste valide. Sinon, la modification de cette propriété conserve la valeur de la propriété « maximumDateTime ».
Cette propriété ne peut être définie que sur une valeur QDateTime valide. La date-heure la plus ancienne acceptée par setMinimumDateTime() correspond au début de l’an 100 de notre ère. La valeur par défaut de la 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 :
| QDateTime | minimumDateTime() const |
| void | setMinimumDateTime(const QDateTime &dt) |
| void | clearMinimumDateTime() |
Voir également maximumDateTime, minimumTime, minimumDate, setDateTimeRange(), QDateTime::isValid() et Keyboard Tracking.
minimumTime : QTime
Cette propriété contient la durée 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 conservant 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, afin de garantir que la plage reste valide. Dans le cas contraire, la modification de cette propriété conserve la propriété « maximumDateTime ».
Cette propriété peut être définie sur n’importe quelle valeur valide de type « QTime ». Par défaut, cette propriété contient une heure de 00:00:00 et 0 milliseconde. Cette valeur par défaut peut être rétablie à l’aide de la méthode clearMinimumTime().
Fonctions d’accès :
| QTime | minimumTime() const |
| void | setMinimumTime(QTime min) |
| void | clearMinimumTime() |
Voir également 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/yy/yyyy », la fonction sectionCount renvoie 3
Fonctions d'accès :
| int | sectionCount() const |
time : QTime
Cette propriété contient l'QTime e définie 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 de notification :
| void | timeChanged(QTime time) |
Voir également « date » et « dateTime ».
[since 6.7] timeZone : QTimeZone
Cette propriété contient le fuseau horaire actuellement utilisé par le widget d'édition de date et d'heure
Si le format de date et d'heure utilisé inclut un indicateur de fuseau horaire — c'est-à-dire un spécificateur de format de type t, tt, ttt ou tttt —, la saisie de l'utilisateur est réécrite dans ce fuseau horaire à chaque analyse, remplaçant ainsi tout fuseau horaire que l'utilisateur aurait pu spécifier.
Cette énumération a été introduite dans Qt 6.7.
Fonctions d'accès :
| QTimeZone | timeZone() const |
| void | setTimeZone(const QTimeZone &zone) |
Voir également QDateTimeEdit::displayFormat.
Documentation des fonctions membres
[explicit] QDateTimeEdit::QDateTimeEdit(QWidget *parent = nullptr)
Crée un éditeur de date et d'heure vide avec une propriété « parent ».
[explicit] QDateTimeEdit::QDateTimeEdit(QDate date, QWidget *parent = nullptr)
Crée un éditeur de date et d'heure vide avec une valeur de type « parent ». La valeur est définie sur « date ».
[explicit] QDateTimeEdit::QDateTimeEdit(QTime time, QWidget *parent = nullptr)
Crée un éditeur de date et d'heure vide avec une valeur de type « parent ». La valeur est définie sur « time ».
[explicit] QDateTimeEdit::QDateTimeEdit(const QDateTime &datetime, QWidget *parent = nullptr)
Crée un éditeur de date et d'heure vide avec une valeur de type « parent ». La valeur est définie sur « datetime ».
[virtual noexcept] QDateTimeEdit::~QDateTimeEdit()
Destructeur.
QCalendar QDateTimeEdit::calendar() const
Indiquez le système de calendrier utilisé par ce widget.
Voir également setCalendar().
QCalendarWidget *QDateTimeEdit::calendarWidget() const
Renvoie le widget de calendrier pour l'éditeur si ` calendarPopup ` est défini sur `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 également setCalendarWidget().
[override virtual] void QDateTimeEdit::clear()
Réimplémente : QAbstractSpinBox::clear().
QDate QDateTimeEdit::date() const
Renvoie la date de la modification de la date et de l'heure.
Remarque : fonction de lecture (getter ) pour la propriété « date ».
Voir aussi setDate().
[signal] void QDateTimeEdit::dateChanged(QDate date)
Ce signal est émis chaque fois que la date est modifiée. La nouvelle date est transmise via la propriété ` date`.
Remarque : signalde notification pour la propriété date.
Voir également Keyboard Tracking.
[signal] void QDateTimeEdit::dateTimeChanged(const QDateTime &datetime)
Ce signal est émis chaque fois que la date ou l'heure est modifiée. La nouvelle date et l'heure sont transmises via ` datetime`.
Remarque : signalde notification pour la propriété dateTime.
Voir également Keyboard Tracking.
[virtual protected] QDateTime QDateTimeEdit::dateTimeFromText(const QString &text) const
Renvoie une date-heure appropriée pour l'text on fournie.
Cette fonction virtuelle est utilisée par le champ de saisie « date et heure » chaque fois qu'il doit interpréter le texte saisi par l'utilisateur comme une valeur.
Voir également 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 ne souhaitent pas renseigner elles-mêmes toutes les informations.
Voir également 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 à l'adresse 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 issu de l'section on indiquée.
Voir aussi currentSection().
void QDateTimeEdit::setCalendar(QCalendar calendar)
Définissez « calendar » comme 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 l'calendarWidget spécifié comme widget à utiliser pour la fenêtre contextuelle du calendrier. L'éditeur ne prend pas automatiquement en charge le widget de calendrier.
Remarque : la propriété ` calendarPopup ` doit être définie sur `true` avant de définir le widget de calendrier.
Voir également calendarWidget() et calendarPopup.
void QDateTimeEdit::setDateRange(QDate min, QDate max)
Définissez la plage de dates autorisées pour la modification de la date et de l'heure.
Cette fonction pratique définit les propriétés « minimumDate » et « maximumDate ».
setDateRange(min, max);Elle est analogue à :
setMinimumDate(min);
setMaximumDate(max);Si l’une des propriétés min ou max n’est pas valide, cette fonction ne fait rien. Cette fonction conserve la propriété minimumTime. Si max est inférieure à min, la nouvelle propriété maximumDateTime doit être la nouvelle propriété minimumDateTime. Si max est égale à min et que la propriété maximumTime était inférieure à la propriété minimumTime, la propriété maximumTime est définie sur la propriété minimumTime. Sinon, cela conserve la propriété maximumTime.
Si la plage est plus courte que l’intervalle de temps dont elle couvre la fin (par exemple, une semaine qui s’étend jusqu’à la fin d’un mois), les utilisateurs ne peuvent modifier la date que pour qu’elle se situe dans la partie la plus récente de la plage 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éfinissez la plage de dates et d'heures autorisées pour la modification de la date et de l'heure.
Cette fonction pratique définit les propriétés « minimumDateTime » et « maximumDateTime ».
setDateTimeRange(min, max);Elle est analogue à :
setMinimumDateTime(min);
setMaximumDateTime(max);Si l’une des propriétés min ou max n’est pas valide, cette fonction ne fait rien. Si max est inférieure à min, min est également utilisée comme max.
Si la plage est plus courte que l’intervalle de temps dont elle couvre la fin (par exemple, une semaine qui s’étend jusqu’à la fin d’un mois), les utilisateurs ne peuvent modifier la date et l’heure que pour une valeur située dans la partie postérieure de la plage si le suivi du clavier est désactivé.
Voir également minimumDateTime, maximumDateTime, setDateRange(), setTimeRange(), QDateTime::isValid() et Keyboard Tracking.
void QDateTimeEdit::setSelectedSection(QDateTimeEdit::Section section)
Sélectionne section. Si section n'existe pas parmi 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 actuelle vers la section sélectionnée.
Voir également currentSection().
void QDateTimeEdit::setTimeRange(QTime min, QTime max)
Définissez la plage horaire autorisée pour la modification de la date et de l'heure.
Cette fonction pratique définit les propriétés « minimumTime » et « maximumTime ».
Notez que celles-ci limitent uniquement la valeur de la saisie de date et d'heure respectivement aux propriétés minimumDate et maximumDate. Lorsque ces propriétés de date ne coïncident pas, les heures postérieures à max sont autorisées pour les dates antérieures à maximumDate et les heures antérieures à min sont autorisées pour les dates postérieures à minimumDate.
setTimeRange(min, max);est analogue à :
setMinimumTime(min);
setMaximumTime(max);Si l’une des propriétés min ou max n’est pas valide, 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érieure à min, min est utilisée comme max.
Si l’intervalle est plus restreint que l’intervalle de temps dont il couvre la fin (par exemple, l’intervalle allant de 10 à une heure, puis jusqu’à 10 minutes après cette même heure), les utilisateurs ne peuvent modifier l’heure que pour une valeur comprise dans la partie la plus tardive de l’intervalle 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émentation de : 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 le champ de saisie date-heure chaque fois qu'il doit afficher dateTime.
Si vous la réimplémentez, vous devrez peut-être également réimplémenter la fonction validate().
Voir également dateTimeFromText() et validate().
QTime QDateTimeEdit::time() const
Renvoie l'heure de la date-heure saisie.
Remarque : fonctionde lecture de 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 via la propriété ` time`.
Remarque : signalde 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.
