QCalendarWidget Class

成员函数文档

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

根据给定的parent 构建一个日历小部件。

该控件初始化时采用当前的月份和年份，且当前选中的日期为今天。

另请参阅 setCurrentPage()。

[virtual noexcept] QCalendarWidget::~QCalendarWidget()

删除日历小部件。

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

每当用户按下“Return”或“Enter”键，或在日历控件中双击date 时，都会发出此信号。

QCalendar QCalendarWidget::calendar() const

报告此小部件所使用的日历系统。

另请参阅 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

返回一个QMap ，其范围从QDate 到QTextCharFormat ，显示所有采用特殊格式且会改变其显示效果的日期。

另请参阅 setDateTextFormat()。

QTextCharFormat QCalendarWidget::dateTextFormat(QDate date) const

返回date 的QTextCharFormat 。如果日期未进行特殊渲染，则char格式可以为空。

[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 设置为该小部件使用的日历系统。

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

另请参阅 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 为 null，则清除所有日期格式。

另请参阅 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()。