C

CalendarModel QML 类型

日历模型。更多...

导入语句	import QtQuick.Calendar 1.0

所有成员的列表，包括继承的成员

属性

from : date
to : date

方法

int indexOf(int year, int month)
int indexOf(Date date)
int monthAt(int index)
int yearAt(int index)

详细说明

CalendarModel 提供了一种创建一系列 MonthGrid 实例的方法。它通常用作一个列表视图的模型，该列表视图使用 MonthGrid 作为代理。

ListView {
    id: listview

    width: 200; height: 200
    snapMode: ListView.SnapOneItem
    orientation: ListView.Horizontal
    highlightRangeMode: ListView.StrictlyEnforceRange

    model: CalendarModel {
        from: new Date(2015, 0, 1)
        to: new Date(2015, 11, 31)
    }

    delegate: MonthGrid {
        width: listview.width
        height: listview.height

        month: model.month
        year: model.year
        locale: Qt.locale("en_US")
    }

    ScrollIndicator.horizontal: ScrollIndicator { }
}

除了 index 属性外，在代理的上下文中还提供了一系列模型数据角色

model.month : int	月份的数字
model.year : int	年份的数字

Qt Quick 日期选择器模块使用 0 基础的月份数字，以与 QML 语言中使用的 JavaScript Date 类型保持一致。这意味着可以将 Date::getMonth() 直接传递给方法。直接处理月份数字时，强烈建议使用以下枚举值以避免混淆。

常量	描述
`Calendar.January`	一月（0）
`Calendar.February`	二月（1）
`Calendar.March`	三月（2）
`Calendar.April`	四月（3）
`Calendar.May`	五月（4）
`Calendar.June`	六月（5）
`Calendar.July`	七月（6）
`Calendar.August`	八月（7）
`Calendar.September`	九月（8）
`Calendar.October`	十月（9）
`Calendar.November`	十一月（10）
`Calendar.December`	十二月（11）

注意：本模块中的类型不保证在将来版本中保持兼容。

另请参阅：MonthGrid 和 Calendar.

属性文档

from : date

此属性持有起始日期。

to : date

此属性持有结束日期。

方法文档

int indexOf(int year, int month)

返回指定 year 和 month 的模型索引。

int indexOf(Date date)

返回指定 date 的模型索引。

int monthAt(int index)

返回指定模型索引月份的编号。

int yearAt(int 索引)

返回指定模型索引年份的编号。

在某些 Qt 许可证下可用。
了解更多信息。