QML类型说明-Calendar

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()

设置显示上一年。