WeekNumberColumn QML Type

一列周数。更多

Import Statement:	`import QtQuick.Controls`
Inherits:	Control

所有成员（包括继承成员）的列表

属性

delegate : Component
month : int
year : int

详细说明

WeekNumberColumn 在一列中显示周数。周数是根据给定的month 和year 计算得出的，使用指定的locale 。

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

WeekNumberColumn 可作为独立控件使用，但最常与MonthGrid 结合使用。无论使用哪种情况，列的定位均由用户自行决定。

RowLayout {
    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.fillHeight: true
    }
}

WeekNumberColumn的可视化外观可通过实现custom delegate 。

另请参见 MonthGrid 和DayOfWeekRow 。

属性文档

delegate : Component

该属性包含可视化每个周数的项目委托。

除了index 属性外，在每个委托的上下文中还有一个模型数据角色列表：

model.weekNumber: int

周数

以下代码段介绍了 item 委托的默认实现。它可以作为实现自定义委托的起点。

delegate: Text {
    text: weekNumber
    font: control.font
    horizontalAlignment: Text.AlignHCenter
    verticalAlignment: Text.AlignVCenter

    required property int weekNumber
}

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.August`	八月 (7)
`Calendar.September`	九月 (8)
`Calendar.October`	十月 (9)
`Calendar.November`	十一月 (10)
`Calendar.December`	十二月 (11)

另请参见 Calendar 。

year : int

该属性用于保存计算星期数的年份数字。

该值必须在-271820 至275759 的范围内。默认值为当前年份。

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.