CalendarModel QML 类型

一个日历模型。更多...

导入语句	import QtQuick.Controls

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

属性

from : date
to : date

方法

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

详细描述

CalendarModel 提供了一种创建一系列 MonthGrid 实例的方法。它通常用作使用 ListView 的模型，其中 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 Calendar 模块使用基于 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(Date date)

返回指定日期的模型索引。

int indexOf(int 年, int 月)

返回指定年和月的模型索引。

int monthAt(int 索引)

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

int yearAt(int 索引)

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