QCalendarWidget 类提供允许用户选择日期,基于月份的日历 Widget。 更多...
头: | #include <QCalendarWidget> |
CMake: |
find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
qmake: | QT += widgets |
继承: | QWidget |
enum | HorizontalHeaderFormat { SingleLetterDayNames, ShortDayNames, LongDayNames, NoHorizontalHeader } |
enum | SelectionMode { NoSelection, SingleSelection } |
enum | VerticalHeaderFormat { ISOWeekNumbers, NoVerticalHeader } |
|
|
QCalendarWidget (QWidget * parent = nullptr) | |
virtual | ~QCalendarWidget () |
QCalendar | calendar () const |
void | clearMaximumDate () |
void | clearMinimumDate () |
int | dateEditAcceptDelay () const |
QMap<QDate, QTextCharFormat> | dateTextFormat () const |
QTextCharFormat | dateTextFormat (QDate date ) const |
Qt::DayOfWeek | firstDayOfWeek () const |
QTextCharFormat | headerTextFormat () const |
QCalendarWidget::HorizontalHeaderFormat | horizontalHeaderFormat () const |
bool | isDateEditEnabled () const |
bool | isGridVisible () const |
bool | isNavigationBarVisible () const |
QDate | maximumDate () const |
QDate | minimumDate () const |
int | monthShown () const |
QDate | selectedDate () const |
QCalendarWidget::SelectionMode | selectionMode () const |
void | setCalendar (QCalendar c ) |
void | setDateEditAcceptDelay (int delay ) |
void | setDateEditEnabled (bool enable ) |
void | setDateTextFormat (QDate date , const QTextCharFormat & format ) |
void | setFirstDayOfWeek (Qt::DayOfWeek dayOfWeek ) |
void | setHeaderTextFormat (const QTextCharFormat & format ) |
void | setHorizontalHeaderFormat (QCalendarWidget::HorizontalHeaderFormat format ) |
void | setMaximumDate (QDate date ) |
void | setMinimumDate (QDate date ) |
void | setSelectionMode (QCalendarWidget::SelectionMode mode ) |
void | setVerticalHeaderFormat (QCalendarWidget::VerticalHeaderFormat format ) |
void | setWeekdayTextFormat (Qt::DayOfWeek dayOfWeek , const QTextCharFormat & format ) |
QCalendarWidget::VerticalHeaderFormat | verticalHeaderFormat () const |
QTextCharFormat | weekdayTextFormat (Qt::DayOfWeek dayOfWeek ) const |
int | yearShown () const |
virtual QSize | minimumSizeHint () const override |
virtual QSize | sizeHint () const override |
void | setCurrentPage (int year , int month ) |
void | setDateRange (QDate min , QDate max ) |
void | setGridVisible (bool show ) |
void | setNavigationBarVisible (bool visible ) |
void | setSelectedDate (QDate date ) |
void | showNextMonth () |
void | showNextYear () |
void | showPreviousMonth () |
void | showPreviousYear () |
void | showSelectedDate () |
void | showToday () |
void | activated (QDate date ) |
void | clicked (QDate date ) |
void | currentPageChanged (int year , int month ) |
void | selectionChanged () |
virtual void | paintCell (QPainter * painter , const QRect & rect , QDate date ) const |
void | updateCell (QDate date ) |
void | updateCells () |
virtual bool | event (QEvent * event ) override |
virtual bool | eventFilter (QObject * watched , QEvent * event ) override |
virtual void | keyPressEvent (QKeyEvent * event ) override |
virtual void | mousePressEvent (QMouseEvent * event ) override |
virtual void | resizeEvent (QResizeEvent * event ) override |
Widget 的初始化是采用当前月和年,但 QCalendarWidget 有提供几个公共槽以改变显示的年和月。
默认情况下,选中今天的日期,且用户可以使用鼠标和键盘两者选择日期。可以检索目前选中的日期使用 selectedDate () 函数。它是可能的将用户选定约束到给定日期范围通过设置 minimumDate and maximumDate 特性。另外,可以一次性设置 2 特性使用 setDateRange () 方便槽。设置 selectionMode 特性到 NoSelection 以从根本上禁止用户选择。注意,还可以以编程方式选择日期使用 setSelectedDate () 槽。
可以检索目前显示的月和年使用 monthShown () 和 yearShown () 函数,分别。
新近创建的日历 Widget 使用缩写的天数名,且周六和周日两者以红色标记。日历栅格不可见。周数显示,且第 1 列天数是日历区域设置每周的第 1 天。
可以将天数的表示法更改为单字母缩写 (M 对于 Monday) 通过设置 horizontalHeaderFormat 特性到 QCalendarWidget::SingleLetterDayNames 。把同一特性设为 QCalendarWidget::LongDayNames 使 Header (头部) 显示完整天数名。可以移除周数通过设置 verticalHeaderFormat 特性到 QCalendarWidget::NoVerticalHeader 。可以打开日历栅格通过设置 gridVisible 特性为 true 使用 setGridVisible () 函数:
QCalendarWidget *calendar; calendar->setGridVisible(true); |
最后,可以更改第 1 列中的天数使用 setFirstDayOfWeek () 函数。
QCalendarWidget 类还提供了 3 信号, selectionChanged (), activated () 和 currentPageChanged () 使之可能响应用户交互。
可以很大程度上定制 Header (头)、工作日 (或单日) 的渲染通过设置 QTextCharFormat 为某些特殊工作日、特殊日期或 Header (头) 的渲染。
仅子集特性在 QTextCharFormat 可以用于日历 Widget。目前,前景、背景及字体特性可以用于确定 Widget 中单个单元格的渲染。
另请参阅 QDate , QDateEdit ,和 QTextCharFormat .
此枚举类型定义水平 Header (头) 可以显示的各种格式。
常量 | 值 | 描述 |
---|---|---|
QCalendarWidget::SingleLetterDayNames
|
1
|
Header (头) 显示用于天数名的单字母缩写 (如 M 对于 Monday). |
QCalendarWidget::ShortDayNames
|
2
|
Header (头) 显示天数名的简短缩写 (如 Mon 对于 Monday)。 |
QCalendarWidget::LongDayNames
|
3
|
Header (头) 显示完整天数名 (如:Monday)。 |
QCalendarWidget::NoHorizontalHeader
|
0
|
头被隐藏。 |
另请参阅 horizontalHeaderFormat () 和 VerticalHeaderFormat .
此枚举描述提供给用户用于在日历中选择日期的选定类型。
常量 | 值 | 描述 |
---|---|---|
QCalendarWidget::NoSelection
|
0
|
无法选择日期。 |
QCalendarWidget::SingleSelection
|
1
|
可以选择单个日期。 |
另请参阅 selectionMode .
此枚举类型定义垂直 Header (头) 可以显示的各种格式。
常量 | 值 | 描述 |
---|---|---|
QCalendarWidget::ISOWeekNumbers
|
1
|
Header (头) 显示 ISO 周数如描述通过 QDate::weekNumber (). |
QCalendarWidget::NoVerticalHeader
|
0
|
头被隐藏。 |
另请参阅 verticalHeaderFormat () 和 HorizontalHeaderFormat .
此特性保持展示非活动日期编辑的时间,在接受其内容前
若日历 Widget 的 日期编辑被启用 , this property specifies the amount of time (in milliseconds) that the date edit remains open after the most recent user input. Once this time has elapsed, the date specified in the date edit is accepted and the popup is closed.
默认情况下,延迟被定义为 1500 毫秒 (1.5 秒)。
访问函数:
int | dateEditAcceptDelay () const |
void | setDateEditAcceptDelay (int delay ) |
此特性保持是否启用日期编辑弹出
If this property is enabled, pressing a non-modifier key will cause a date edit to popup if the calendar widget has focus, allowing the user to specify a date in the form specified by the current locale.
By default, this property is enabled.
The date edit is simpler in appearance than QDateEdit , but allows the user to navigate between fields using the left and right cursor keys, increment and decrement individual fields using the up and down cursor keys, and enter values directly using the number keys.
访问函数:
bool | isDateEditEnabled () const |
void | setDateEditEnabled (bool enable ) |
另请参阅 QCalendarWidget::dateEditAcceptDelay .
此特性保持第 1 列显示天数的标识值。
默认情况下,第 1 列显示的天数是日历区域设置每周的第 1 天。
访问函数:
Qt::DayOfWeek | firstDayOfWeek () const |
void | setFirstDayOfWeek (Qt::DayOfWeek dayOfWeek ) |
此特性保持是否显示表格栅格。
QCalendarWidget *calendar; calendar->setGridVisible(true); |
默认值为 false。
访问函数:
bool | isGridVisible () const |
void | setGridVisible (bool show ) |
此特性保持水平 Header (头) 的格式。
默认值为 QCalendarWidget::ShortDayNames .
访问函数:
QCalendarWidget::HorizontalHeaderFormat | horizontalHeaderFormat () const |
void | setHorizontalHeaderFormat (QCalendarWidget::HorizontalHeaderFormat format ) |
此特性保持目前指定日期范围的最大日期。
The user will not be able to select a date which is after the currently set maximum date.
QCalendarWidget *calendar; calendar->setGridVisible(true); calendar->setMaximumDate(QDate(2006, 7, 3)); |
When setting a maximum date, the minimumDate and selectedDate properties are adjusted if the selection range becomes invalid. If the provided date is not a valid QDate object, the setMaximumDate() function does nothing.
The default maximum date is December 31, 9999 CE. You can restore this default by calling clearMaximumDate() (since Qt 6.6).
访问函数:
QDate | maximumDate () const |
void | setMaximumDate (QDate date ) |
void | clearMaximumDate () |
另请参阅 setDateRange ().
This property holds the minimum date of the currently specified date range.
The user will not be able to select a date that is before the currently set minimum date.
QCalendarWidget *calendar; calendar->setGridVisible(true); calendar->setMinimumDate(QDate(2006, 6, 19)); |
When setting a minimum date, the maximumDate and selectedDate properties are adjusted if the selection range becomes invalid. If the provided date is not a valid QDate object, the setMinimumDate() function does nothing.
The default minimum date is November 25, 4714 BCE. You can restore this default by calling clearMinimumDate() (since Qt 6.6).
访问函数:
QDate | minimumDate () const |
void | setMinimumDate (QDate date ) |
void | clearMinimumDate () |
另请参阅 setDateRange ().
This property holds whether the navigation bar is shown or not
When this property is
true
(the default), the next month, previous month, month selection, year selection controls are shown on top.
When the property is set to false, these controls are hidden.
访问函数:
bool | isNavigationBarVisible () const |
void | setNavigationBarVisible (bool visible ) |
此特性保持目前选中的日期。
The selected date must be within the date range specified by the minimumDate and maximumDate properties. By default, the selected date is the current date.
访问函数:
QDate | selectedDate () const |
void | setSelectedDate (QDate date ) |
另请参阅 setDateRange ().
This property holds the type of selection the user can make in the calendar
当此特性被设为 SingleSelection , the user can select a date within the minimum and maximum allowed dates, using either the mouse or the keyboard.
当特性被设为 NoSelection , the user will be unable to select dates, but they can still be selected programmatically. Note that the date that is selected when the property is set to NoSelection will still be the selected date of the calendar.
默认值为 SingleSelection .
访问函数:
QCalendarWidget::SelectionMode | selectionMode () const |
void | setSelectionMode (QCalendarWidget::SelectionMode mode ) |
This property holds the format of the vertical header.
The default value is QCalendarWidget::ISOWeekNumber.
访问函数:
QCalendarWidget::VerticalHeaderFormat | verticalHeaderFormat () const |
void | setVerticalHeaderFormat (QCalendarWidget::VerticalHeaderFormat format ) |
[explicit]
QCalendarWidget::
QCalendarWidget
(
QWidget
*
parent
= nullptr)
构造日历 Widget 采用给定 parent .
The widget is initialized with the current month and year, and the currently selected date is today.
另请参阅 setCurrentPage ().
[virtual noexcept]
QCalendarWidget::
~QCalendarWidget
()
Destroys the calendar widget.
[signal]
void
QCalendarWidget::
activated
(
QDate
date
)
This signal is emitted whenever the user presses the Return or Enter key or double-clicks a date in the calendar widget.
Report the calendar system in use by this widget.
另请参阅 setCalendar ().
[signal]
void
QCalendarWidget::
clicked
(
QDate
date
)
This signal is emitted when a mouse button is clicked. The date the mouse was clicked on is specified by date . The signal is only emitted when clicked on a valid date, e.g., dates are not outside the minimumDate () 和 maximumDate (). If the selection mode is NoSelection , this signal will not be emitted.
[signal]
void
QCalendarWidget::
currentPageChanged
(
int
year
,
int
month
)
This signal is emitted when the currently shown month is changed. The new year and month are passed as parameters.
另请参阅 setCurrentPage ().
返回 QMap from QDate to QTextCharFormat showing all dates that use a special format that alters their rendering.
另请参阅 setDateTextFormat ().
返回 QTextCharFormat for date . The char format can be empty if the date is not renderd specially.
[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).
Returns the text char format for rendering the header.
另请参阅 setHeaderTextFormat ().
[override virtual protected]
void
QCalendarWidget::
keyPressEvent
(
QKeyEvent
*
event
)
重实现: QWidget::keyPressEvent (QKeyEvent *event).
[override virtual]
QSize
QCalendarWidget::
minimumSizeHint
() const
重实现访问函数为特性: QWidget::minimumSizeHint .
Returns the currently displayed month. Months are numbered from 1 to 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
描绘单元格指定通过给定 date ,使用给定 painter and rect .
[override virtual protected]
void
QCalendarWidget::
resizeEvent
(
QResizeEvent
*
event
)
重实现: QWidget::resizeEvent (QResizeEvent *event).
[signal]
void
QCalendarWidget::
selectionChanged
()
此信号被发射,当目前选中日期改变时。
The currently selected date can be changed by the user using the mouse or keyboard, or by the programmer using setSelectedDate ().
另请参阅 selectedDate ().
Set c as the calendar system to be used by this widget.
The widget can use any supported calendar system. By default, it uses the Gregorian calendar.
另请参阅 calendar ().
[slot]
void
QCalendarWidget::
setCurrentPage
(
int
year
,
int
month
)
显示给定 month 为给定 year without changing the selected date. Use the setSelectedDate () function to alter the selected date.
可以检索目前显示的月和年使用 monthShown () 和 yearShown () 函数分别。
另请参阅 yearShown (), monthShown (), showPreviousMonth (), showNextMonth (), showPreviousYear (),和 showNextYear ().
[slot]
void
QCalendarWidget::
setDateRange
(
QDate
min
,
QDate
max
)
定义日期范围通过设置 minimumDate and maximumDate 特性。
The date range restricts the user selection, i.e. the user can only select dates within the specified date range. Note that
QCalendarWidget *calendar; calendar->setDateRange(min, max);
is analogous to
QCalendarWidget *calendar; calendar->setMinimumDate(min); calendar->setMaximumDate(max);
若 min or max 参数是无效 QDate 对象,此函数什么都不做。
另请参阅 setMinimumDate () 和 setMaximumDate ().
Sets the format used to render the given date to that specified by format .
若 date 为 null,清零所有日期格式。
另请参阅 dateTextFormat ().
Sets the text char format for rendering the header to format . If you also set a weekday text format, this format's foreground and background color will take precedence over the header's format. The other formatting information will still be decided by the header's format.
另请参阅 headerTextFormat ().
Sets the text char format for rendering of day in the week dayOfWeek to format . The format will take precedence over the header format in case of foreground and background color. Other text formatting information is taken from the headers format.
另请参阅 weekdayTextFormat () 和 setHeaderTextFormat ().
[slot]
void
QCalendarWidget::
showNextMonth
()
Shows the next month relative to the currently displayed month. Note that the selected date is not changed.
另请参阅 showPreviousMonth (), setCurrentPage (),和 setSelectedDate ().
[slot]
void
QCalendarWidget::
showNextYear
()
Shows the currently displayed month in the next year relative to the currently displayed year. Note that the selected date is not changed.
另请参阅 showPreviousYear (), setCurrentPage (),和 setSelectedDate ().
[slot]
void
QCalendarWidget::
showPreviousMonth
()
Shows the previous month relative to the currently displayed month. Note that the selected date is not changed.
另请参阅 showNextMonth (), setCurrentPage (),和 setSelectedDate ().
[slot]
void
QCalendarWidget::
showPreviousYear
()
Shows the currently displayed month in the 上一 year relative to the currently displayed year. Note that the selected date is not changed.
另请参阅 showNextYear (), setCurrentPage (),和 setSelectedDate ().
[slot]
void
QCalendarWidget::
showSelectedDate
()
Shows the month of the selected date.
另请参阅 selectedDate () 和 setCurrentPage ().
[slot]
void
QCalendarWidget::
showToday
()
Shows the month of the today's date.
另请参阅 selectedDate () 和 setCurrentPage ().
[override virtual]
QSize
QCalendarWidget::
sizeHint
() const
重实现访问函数为特性: QWidget::sizeHint .
[protected]
void
QCalendarWidget::
updateCell
(
QDate
date
)
Updates the cell specified by the given date unless updates are disabled or the cell is hidden.
另请参阅 updateCells (), yearShown (),和 monthShown ().
[protected]
void
QCalendarWidget::
updateCells
()
更新所有可见单元格,除非更新被禁用。
另请参阅 updateCell ().
返回的文本字符格式用于渲染天按周 dayOfWeek .
另请参阅 setWeekdayTextFormat () 和 headerTextFormat ().
返回目前显示月的年。月的编号是从 1 到 12。
另请参阅 monthShown () 和 setCurrentPage ().