QCalendarWidget Class

Documentation des fonctions membres

[explicit] QCalendarWidget::QCalendarWidget(QWidget *parent = nullptr)

Crée un widget de calendrier à partir de l'parent.

Le widget est initialisé avec le mois et l'année en cours, et la date actuellement sélectionnée est celle d'aujourd'hui.

Voir également setCurrentPage().

[virtual noexcept] QCalendarWidget::~QCalendarWidget()

Supprime le widget calendrier.

[signal] void QCalendarWidget::activated(QDate date)

Ce signal est émis chaque fois que l'utilisateur appuie sur la touche Retour ou Entrée, ou qu'il double-clique sur un « date » dans le widget de calendrier.

QCalendar QCalendarWidget::calendar() const

Indiquez le système de calendrier utilisé par ce widget.

Voir également setCalendar().

[signal] void QCalendarWidget::clicked(QDate date)

Ce signal est émis lorsqu'on clique sur un bouton de la souris. La date sur laquelle on a cliqué est spécifiée par date. Le signal n'est émis que si l'on clique sur une date valide, c'est-à-dire si les dates ne se situent pas en dehors des plages définies par minimumDate() et maximumDate(). Si le mode de sélection est NoSelection, ce signal ne sera pas émis.

[signal] void QCalendarWidget::currentPageChanged(int year, int month)

Ce signal est émis lorsque le mois actuellement affiché change. Les nouvelles valeurs de « year » et « month » sont transmises en tant que paramètres.

Voir également setCurrentPage().

QMap<QDate, QTextCharFormat> QCalendarWidget::dateTextFormat() const

Renvoie une liste « QMap » (liste des dates) de QDate vers QTextCharFormat, indiquant toutes les dates qui utilisent un format spécial modifiant leur affichage.

Voir aussi setDateTextFormat().

QTextCharFormat QCalendarWidget::dateTextFormat(QDate date) const

Renvoie un objet ` QTextCharFormat ` pour ` date`. Le format `char` peut être vide si la date ne fait pas l'objet d'un rendu particulier.

[override virtual protected] bool QCalendarWidget::event(QEvent *event)

Réimplémente : QWidget::event(QEvent *event).

[override virtual protected] bool QCalendarWidget::eventFilter(QObject *watched, QEvent *event)

Réimplémente : QObject::eventFilter(QObject *watched, QEvent *event).

QTextCharFormat QCalendarWidget::headerTextFormat() const

Renvoie le format de chaîne de caractères à utiliser pour l'affichage de l'en-tête.

Voir aussi setHeaderTextFormat().

[override virtual protected] void QCalendarWidget::keyPressEvent(QKeyEvent *event)

Réimplémente : QWidget::keyPressEvent(QKeyEvent *event).

[override virtual] QSize QCalendarWidget::minimumSizeHint() const

Réimplémente une fonction d'accès pour la propriété : QWidget::minimumSizeHint.

int QCalendarWidget::monthShown() const

Renvoie le mois actuellement affiché. Les mois sont numérotés de 1 à 12.

Voir également yearShown() et setCurrentPage().

[override virtual protected] void QCalendarWidget::mousePressEvent(QMouseEvent *event)

Réimplémente : QWidget::mousePressEvent(QMouseEvent *event).

[virtual protected] void QCalendarWidget::paintCell(QPainter *painter, const QRect &rect, QDate date) const

Peint la cellule spécifiée par l'date, en utilisant les paramètres painter et rect fournis.

[override virtual protected] void QCalendarWidget::resizeEvent(QResizeEvent *event)

Réimplémente : QWidget::resizeEvent(QResizeEvent *event).

[signal] void QCalendarWidget::selectionChanged()

Ce signal est émis lorsque la date actuellement sélectionnée est modifiée.

La date actuellement sélectionnée peut être modifiée par l'utilisateur à l'aide de la souris ou du clavier, ou par le programmeur à l'aide de la fonction setSelectedDate().

Voir également selectedDate().

void QCalendarWidget::setCalendar(QCalendar c)

Définissez « c » 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 également calendar().

[slot] void QCalendarWidget::setCurrentPage(int year, int month)

Affiche l'month ion spécifiée de l'year ion indiquée sans modifier la date sélectionnée. Utilisez la fonction setSelectedDate() pour modifier la date sélectionnée.

Le mois et l'année actuellement affichés peuvent être récupérés à l'aide des fonctions monthShown() et yearShown(), respectivement.

Voir également yearShown(), monthShown(), showPreviousMonth(), showNextMonth(), showPreviousYear() et showNextYear().

[slot] void QCalendarWidget::setDateRange(QDate min, QDate max)

Définit une plage de dates en configurant les propriétés « minimumDate » et « maximumDate ».

Cette plage de dates limite la sélection de l’utilisateur, c’est-à-dire que celui-ci ne peut choisir que des dates comprises dans la plage spécifiée. Notez que

QCalendarWidget *calendar;

calendar->setDateRange(min, max);

est analogue à

QCalendarWidget *calendar;

calendar->setMinimumDate(min);
calendar->setMaximumDate(max);

Si l'un des paramètres min ou max n'est pas un objet QDate valide, cette fonction ne fait rien.

Voir également setMinimumDate() et setMaximumDate().

void QCalendarWidget::setDateTextFormat(QDate date, const QTextCharFormat &format)

Définit le format utilisé pour afficher l'date s fournies selon celui spécifié par format.

Si date est nul, tous les formats de date sont effacés.

Voir également dateTextFormat().

void QCalendarWidget::setHeaderTextFormat(const QTextCharFormat &format)

Définit le format de caractères du texte pour l'affichage de l'en-tête selon format. Si vous définissez également un format de texte pour les jours de la semaine, les couleurs de premier plan et d'arrière-plan de ce format prévaudront sur celles du format de l'en-tête. Les autres informations de mise en forme resteront déterminées par le format de l'en-tête.

Voir aussi headerTextFormat().

void QCalendarWidget::setWeekdayTextFormat(Qt::DayOfWeek dayOfWeek, const QTextCharFormat &format)

Définit le format de caractères pour l'affichage du jour de la semaine dayOfWeek à format. Ce format prévaut sur le format des en-têtes en ce qui concerne les couleurs de premier plan et d'arrière-plan. Les autres informations de mise en forme du texte sont reprises du format des en-têtes.

Voir également weekdayTextFormat() et setHeaderTextFormat().

[slot] void QCalendarWidget::showNextMonth()

Affiche le mois suivant par rapport au mois actuellement affiché. Notez que la date sélectionnée n'est pas modifiée.

Voir également showPreviousMonth(), setCurrentPage() et setSelectedDate().

[slot] void QCalendarWidget::showNextYear()

Affiche le mois de l'année suivante par rapport à l'année actuellement affichée. Notez que la date sélectionnée n'est pas modifiée.

Voir également showPreviousYear(), setCurrentPage() et setSelectedDate().

[slot] void QCalendarWidget::showPreviousMonth()

Affiche le mois précédent par rapport au mois actuellement affiché. Notez que la date sélectionnée n'est pas modifiée.

Voir également showNextMonth(), setCurrentPage() et setSelectedDate().

[slot] void QCalendarWidget::showPreviousYear()

Affiche le mois de l'année précédente correspondant à l'année actuellement affichée. Notez que la date sélectionnée n'est pas modifiée.

Voir également showNextYear(), setCurrentPage() et setSelectedDate().

[slot] void QCalendarWidget::showSelectedDate()

Affiche le mois correspondant à la date sélectionnée.

Voir également selectedDate() et setCurrentPage().

[slot] void QCalendarWidget::showToday()

Affiche le mois correspondant à la date du jour.

Voir également selectedDate() et setCurrentPage().

[override virtual] QSize QCalendarWidget::sizeHint() const

Réimplémente une fonction d'accès pour la propriété : QWidget::sizeHint.

[protected] void QCalendarWidget::updateCell(QDate date)

Met à jour la cellule spécifiée par l'date fournie, sauf si les mises à jour sont désactivées ou si la cellule est masquée.

Voir également updateCells(), yearShown() et monthShown().

[protected] void QCalendarWidget::updateCells()

Met à jour toutes les cellules visibles, sauf si cette fonctionnalité est désactivée.

Voir également updateCell().

QTextCharFormat QCalendarWidget::weekdayTextFormat(Qt::DayOfWeek dayOfWeek) const

Renvoie le format de chaîne de caractères permettant d'afficher le jour de la semaine dayOfWeek.

Voir également setWeekdayTextFormat() et headerTextFormat().

int QCalendarWidget::yearShown() const

Renvoie l'année du mois actuellement affiché. Les mois sont numérotés de 1 à 12.

Voir également monthShown() et setCurrentPage().