Calendar
ImportStatement: import QtQuick.Controls 1.2
Since: Qt 5.3
Inherits: FocusScope
Properties
dayOfWeekFormat: int
frameVisible: bool
maximumDate: date
minimumDate: date
selectedDate: date
style :Component
visibleMonth: int
visibleYear: int
weekNumbersVisible: bool
Signals
clicked(datedate)
doubleClicked(datedate)
hovered(datedate)
pressed(datedate)
released(datedate)
Methods
showNextMonth()
showNextYear()
showPreviousMonth()
showPreviousYear()
DetailedDescription
日历组件允许从天的网格中选择日期,如同QCalendarWidget。选择日期可以用鼠标,也可以用键盘导航。
选择日期能通过selectedDate属性设置。最小日期和最大日期能通过minimumDate和maximumDate设置。最早的最小日期为公元1年1月1日,最大的最大日期为公元275759年10月25日。
选择的日期以应用程序的缺省环境的格式显示,通过设置weekNumbersVisible,则能显示星期几。我们也能通过设置CalendarStyle,来创建自定义的显示样式显示日期。
PropertyDocumentation
dayOfWeekFormat: int
星期几的显示格式。Locale.ShortFormat是默认并被推荐的显示格式,Locale.NarrowFormat在一些语言环境中没有被支持,而Locale.LongFormat有时候太长了,常常不知不觉超出我们的头单元空间。
frameVisible: bool
日历周围框架是否可见,默认为真。
maximumDate: date
日历接受的最大日期。默认设置为公元275759年10月25日。
minimumDate: date
日历接受的最小日期,默认设置为公元1年1月1日。
selectedDate: date
被用户选择的日期。这个属性按照下面的规则验证:
如果选择日期超出最小日期和最大日期的范围,将被强制放到范围中。
未定义或无效的分配值不会改变选择日期。
设置的小时、分钟、秒和毫秒会被移除。
默认值是当前日期,相当于new Date()。
style :Component
日历显示的样式。
visibleMonth: int
在可见的年的那个月被显示在日历上。月为从0到11的数,和JavaScript Date一致。
visibleYear: int
哪一年被显示在日历上。
weekNumbersVisible: bool
星期几是否显示在日历上。默认为假。
SignalDocumentation
clicked(datedate)
当鼠标点击在有效的日期上时发射这个信号。date是鼠标点击的日期。
doubleClicked(datedate)
当鼠标在有效的日期上双击时发射这个信号,date是鼠标双击的日期。
hovered(datedate)
当鼠标进入有效的日期发射这个信号,date是鼠标悬停的日期。
pressed(datedate)
当鼠标在有效的日期上按下时发射这个信号。当鼠标在按下的状态下拖入另一个日期,这个信号也将发射。date是鼠标按下所在的日期。
released(datedate)
当鼠标在有效的日期上释放,则发射这个信号。date是鼠标释放时的日期。
Method Documentation
showNextMonth()
设置显示出下一月。
showNextYear()
设置显示下一年。
showPreviousMonth()
设置显示上一月。
showPreviousYear()
设置显示上一年。