C

月格 QML 类型

日历月份一天的网格。 更多信息...

导入声明import QtQuick.Calendar 1.0
继承

控件

属性

信号

详细说明

MonthGrid 以网格形式呈现月历。内容是根据指定的月份和年份，以及地区进行的计算。

MonthGrid {
    month: Calendar.December
    year: 2015
    locale: Qt.locale("en_US")
}

MonthGrid 可以用作独立控件，但它最常与 DayOfWeekRow 和 WeekNumberColumn 一起使用。无论用例如何，网格的位置留给用户决定。

GridLayout {
    columns: 2

    DayOfWeekRow {
        locale: grid.locale

        Layout.column: 1
        Layout.fillWidth: true
    }

    WeekNumberColumn {
        month: grid.month
        year: grid.year
        locale: grid.locale

        Layout.fillHeight: true
    }

    MonthGrid {
        id: grid
        month: Calendar.December
        year: 2015
        locale: Qt.locale("en_US")

        Layout.fillWidth: true
        Layout.fillHeight: true
    }
}

通过实现一个自定义 代理 来改变 MonthGrid 的外观。

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

另请参阅DayOfWeekRow，WeekNumberColumn 以及 CalendarModel。

属性文档

delegate : 组件

此属性包含可视化每一天的项目代理。

除了 index 属性外，每个代理上下文中都可用模型数据角色列表

model.date : 日期单元格的日期
model.day : int天数
model.today : bool代理人是否代表今天
model.weekNumber : int周数
model.month : int月份
model.year : int年份

以下片段显示了项目代理的默认实现。它可以作为实现自定义代理的起点。

delegate: Text {
    horizontalAlignment: Text.AlignHCenter
    verticalAlignment: Text.AlignVCenter
    opacity: model.month === control.month ? 1 : 0
    text: model.day
    font: control.font
}

month : 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.八月八月（7号）
Calendar.九月九月（8号）
Calendar.十月十月（9号）
Calendar.十一月十一月（10号）
Calendar.十二月十二月（11号）

参阅以下内容 日历.


title : string

此属性包含日历的标题。

此属性提供方便。本身不可视化标题。MonthGrid的默认值由月份名称和年份组成，使用区域设置格式化。


year : int

此属性包含年份的数字。

值必须在从-271820到275759的范围内。默认值是当前年份。


信号文档

clicked(date date)

当点击date时发出此信号。

注意：相应的事件处理函数是onClicked。


pressAndHold(date date)

当按下并持续按下date时发出此信号。

注意：相应的事件处理函数是onPressAndHold。


pressed(date date)

当按下date时发出此信号。

注意：相应的事件处理函数是onPressed。


released(date date)

当释放date时发出此信号。

注意：相应的事件处理函数是onReleased。


在某些Qt许可下提供。
了解更多。