QCalendarWidget Class

Documentation des fonctions membres

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

Construit un widget calendrier avec l'adresse parent.

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

Voir aussi setCurrentPage().

[virtual noexcept] QCalendarWidget::~QCalendarWidget()

Détruit le widget du calendrier.

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

Ce signal est émis lorsque l'utilisateur appuie sur la touche Retour ou Entrée ou double-clique sur date dans le widget du calendrier.

QCalendar QCalendarWidget::calendar() const

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

Voir aussi setCalendar().

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

Ce signal est émis lorsqu'un bouton de la souris est cliqué. La date à laquelle la souris a été cliquée 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 zones minimumDate() et maximumDate(). Si le mode de sélection est NoSelection, ce signal n'est pas émis.

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

Ce signal est émis lorsque le mois affiché est modifié. Les nouveaux year et month sont transmis en tant que paramètres.

Voir aussi setCurrentPage().

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

Retourne un QMap de QDate à QTextCharFormat montrant toutes les dates qui utilisent un format spécial qui modifie leur rendu.

Voir aussi setDateTextFormat().

QTextCharFormat QCalendarWidget::dateTextFormat(QDate date) const

Renvoie une adresse QTextCharFormat pour date. Le format char peut être vide si la date n'est pas rendue spécialement.

[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 texte char pour le rendu 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 à la propriété : QWidget::minimumSizeHint.

int QCalendarWidget::monthShown() const

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

Voir aussi 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'adresse date, en utilisant les adresses painter et rect.

[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 sélectionnée est modifiée.

La date 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 setSelectedDate().

Voir également selectedDate().

void QCalendarWidget::setCalendar(QCalendar c)

Définit c 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().

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

Affiche l'adresse month de l'adresse year 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 définissant les propriétés minimumDate et maximumDate.

La plage de dates restreint la sélection de l'utilisateur, c'est-à-dire que l'utilisateur ne peut sélectionner que des dates comprises dans la plage de dates spécifiée. Notez que

QCalendarWidget *calendar;

calendar->setDateRange(min, max);

est analogue à

QCalendarWidget *calendar;

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

Si les paramètres min ou max ne sont pas des objets QDate valides, cette fonction ne fait rien.

Voir également setMinimumDate() et setMaximumDate().

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

Définit le format utilisé pour le rendu de la date donnée date à celui spécifié par format.

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

Voir aussi dateTextFormat().

void QCalendarWidget::setHeaderTextFormat(const QTextCharFormat &format)

Définit le format de texte pour le rendu de l'en-tête à format. Si vous définissez également un format de texte pour le jour de la semaine, les couleurs d'avant-plan et d'arrière-plan de ce format auront la priorité sur le format de l'en-tête. Les autres informations de formatage seront toujours 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 des caractères de texte pour le rendu du jour de la semaine dayOfWeek à format. Le format aura la priorité sur le format de l'en-tête en ce qui concerne la couleur d'avant-plan et d'arrière-plan. Les autres informations de formatage du texte sont tirées du format des en-têtes.

Voir aussi 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 actuellement affiché dans 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 en cours dans l'année précédente par rapport à l'année en cours. 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 de la date sélectionnée.

Voir aussi selectedDate() et setCurrentPage().

[slot] void QCalendarWidget::showToday()

Affiche le mois de la date du jour.

Voir aussi selectedDate() et setCurrentPage().

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

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

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

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

Voir aussi updateCells(), yearShown() et monthShown().

[protected] void QCalendarWidget::updateCells()

Met à jour toutes les cellules visibles, sauf si les mises à jour sont désactivées.

Voir également updateCell().

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

Renvoie le format texte char pour le rendu du jour de la semaine dayOfWeek.

Voir aussi setWeekdayTextFormat() et headerTextFormat().

int QCalendarWidget::yearShown() const

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

Voir aussi monthShown() et setCurrentPage().