CalendarDatePicker¶
Date field with calendar flyout.
import QWinUI3.Extras · src/extras/QWinUI3/Extras/CalendarDatePicker.qml
Category: Date & time · Library: v2.80
Gallery: CalendarDatePicker — src/gallery/pages/CalendarDatePickerPage.qml
Extends Control.
Example¶
CalendarDatePicker {
id: calendarDatePicker
selectedDate: new Date()
}
// --- API ---
// signals: onDateChosen
// methods: isDateAllowed(d)
// calendarDatePicker.isDateAllowed(d)
Notes¶
Text field + calendar flyout (MonthGrid); selectedDate with min/max bounds. FirstDayOfWeek remaps calendar locale (WinUI CalendarView.FirstDayOfWeek). Form: header / description / errorMessage / hasError (1.28) — FormLayout.validate().
API¶
Properties¶
| Name | Type | Description |
|---|---|---|
selectedDate |
date |
Currently selected date |
date |
alias |
WinUI Date alias of selectedDate |
calendarOpen |
bool |
Calendar flyout open |
isOpen |
alias |
Open / visible state |
isCalendarOpen |
alias |
WinUI IsCalendarOpen |
dateFormat |
string |
Display date format |
showTodayButton |
bool |
Show Today button in calendar |
isTodayHighlighted |
bool |
Highlight today ring (MonthGrid isToday) |
header |
string |
Header label above the control |
description |
string |
Supporting description text |
errorMessage |
string |
Validation error text (FormLayout) |
hasError |
bool |
True when validation failed |
placeholderText |
string |
Placeholder when empty |
minDate |
date |
Minimum selectable date |
maxDate |
date |
Maximum selectable date |
blackoutDates |
var |
Dates that cannot be selected — synced with CalendarView (2.69 D5) |
blackoutFilter |
var |
— |
hasMinDate |
bool |
True when minDate is set |
hasMaxDate |
bool |
True when maxDate is set |
firstDayOfWeek |
int |
WinUI FirstDayOfWeek — Qt.Sunday..Qt.Saturday, or -1 for system default |
calendarLocale |
var |
Locale whose firstDayOfWeek matches the requested start day |
Signals¶
| Signature | Description |
|---|---|
dateChosen(date date) |
Emitted when a date is chosen |
Methods¶
| Signature | Description |
|---|---|
isDateAllowed(d) |
True when the date is within selectable bounds |
Inherited from Control¶
Also available (base type / Qt Quick Controls):
paddingfontbackground/contentItem
Generated from module sources by scripts/generate_component_docs.py — do not edit by hand.