QCalendarWidget Class

成员函数文档

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

用给定的parent 构建一个日历部件。

该部件用当前的年月日初始化，当前选择的日期是今天。

另请参阅 setCurrentPage() 。

[virtual noexcept] QCalendarWidget::~QCalendarWidget()

销毁日历部件。

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

每当用户按下回车键或回车键，或双击日历部件中的date 时，就会发出该信号。

QCalendar QCalendarWidget::calendar() const

报告此 widget 使用的日历系统。

另请参见 setCalendar()。

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

点击鼠标按钮时发出该信号。鼠标点击的日期由date 指定。只有点击有效日期时，例如日期不在minimumDate() 和maximumDate() 范围内，才会发出该信号。如果选择模式为NoSelection ，则不会发出该信号。

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

当当前显示的月份发生变化时，就会发出该信号。新的year 和month 将作为参数传递。

另请参阅 setCurrentPage() 。

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

返回一个从QDate 到QTextCharFormat 的QMap ，显示所有使用特殊格式的日期，这种格式会改变日期的显示方式。

另请参阅 setDateTextFormat().

QTextCharFormat QCalendarWidget::dateTextFormat(QDate date) const

返回date 的QTextCharFormat 。如果日期没有特别渲染，字符格式可以为空。

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

重实现：QWidget::event(QEvent *event).

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

重实现：QObject::eventFilter(QObject *watched, QEvent *event).

QTextCharFormat QCalendarWidget::headerTextFormat() const

返回渲染页眉的文本字符格式。

另请参阅 setHeaderTextFormat().

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

重实现：QWidget::keyPressEvent(QKeyEvent *event).

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

重构属性访问函数：QWidget::minimumSizeHint 。

int QCalendarWidget::monthShown() const

返回当前显示的月份。月份编号从 1 到 12。

另请参阅 yearShown() 和setCurrentPage()。

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

重实现：QWidget::mousePressEvent(QMouseEvent *event).

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

使用给定的painter 和rect 绘制date 指定的单元格。

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

重实现：QWidget::resizeEvent(QResizeEvent *event).

[signal] void QCalendarWidget::selectionChanged()

当当前选择的日期发生变化时，就会发出该信号。

用户可以使用鼠标或键盘更改当前选择的日期，程序员也可以使用setSelectedDate() 更改当前选择的日期。

另请参阅 selectedDate()。

void QCalendarWidget::setCalendar(QCalendar c)

将c 设置为该 widget 使用的日历系统。

该 widget 可以使用任何支持的日历系统。默认情况下，它使用公历。

另请参阅 calendar().

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

在不更改所选日期的情况下，显示给定year 的给定month 。使用setSelectedDate() 函数可更改所选日期。

当前显示的月份和年份可分别使用monthShown() 和yearShown() 函数获取。

另请参阅 yearShown()、monthShown()、showPreviousMonth()、showNextMonth()、showPreviousYear() 和showNextYear()。

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

通过设置minimumDate 和maximumDate 属性来定义日期范围。

日期范围限制了用户的选择，即用户只能选择指定日期范围内的日期。请注意

QCalendarWidget *calendar;

calendar->setDateRange(min, max);

类似于

QCalendarWidget *calendar;

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

如果min 或max 参数不是有效的QDate 对象，则该函数不会执行任何操作。

另请参阅 setMinimumDate() 和setMaximumDate()。

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

将用于显示date 的格式设置为format 指定的格式。

如果date 为空，则清除所有日期格式。

另请参阅 dateTextFormat().

void QCalendarWidget::setHeaderTextFormat(const QTextCharFormat &format)

将渲染页眉的文本字符格式设置为format 。如果同时设置了工作日文本格式，该格式的前景色和背景色将优先于页眉格式。其他格式信息仍由页眉格式决定。

另请参阅 headerTextFormat() 。

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

设置用于显示星期的文本字符格式dayOfWeek 至format 。在前景和背景颜色方面，该格式优先于页眉格式。其他文本格式信息取自页眉格式。

另请参阅 weekdayTextFormat() 和setHeaderTextFormat()。

[slot] void QCalendarWidget::showNextMonth()

显示相对于当前显示月份的下一个月。请注意，所选日期不会更改。

另请参阅 showPreviousMonth()、setCurrentPage() 和setSelectedDate()。

[slot] void QCalendarWidget::showNextYear()

相对于当前显示的年份，显示下一年中当前显示的月份。请注意，所选日期不会更改。

另请参阅 showPreviousYear()、setCurrentPage() 和setSelectedDate()。

[slot] void QCalendarWidget::showPreviousMonth()

显示相对于当前显示月份的前一个月。请注意，所选日期不会更改。

另请参阅 showNextMonth()、setCurrentPage() 和setSelectedDate()。

[slot] void QCalendarWidget::showPreviousYear()

显示当前显示的月份相对于前一年的月份。请注意，所选日期不会更改。

另请参阅 showNextYear()、setCurrentPage() 和setSelectedDate()。

[slot] void QCalendarWidget::showSelectedDate()

显示所选日期的月份。

另请参阅 selectedDate() 和setCurrentPage()。

[slot] void QCalendarWidget::showToday()

显示今天日期的月份。

另请参阅 selectedDate() 和setCurrentPage()。

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

重构属性访问函数：QWidget::sizeHint 。

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

更新date 指定的单元格，除非已禁用更新或单元格已隐藏。

另请参阅 updateCells()、yearShown() 和monthShown()。

[protected] void QCalendarWidget::updateCells()

更新所有可见单元格，除非已禁用更新。

另请参见 updateCell().

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

返回用于显示星期的文本字符格式dayOfWeek 。

另请参阅 setWeekdayTextFormat() 和headerTextFormat()。

int QCalendarWidget::yearShown() const

返回当前显示月份的年份。月份编号从 1 到 12。

另请参阅 monthShown() 和setCurrentPage()。