En esta página

WeekNumberColumn QML Type

Una columna de números de semana. Más...

Import Statement: import QtQuick.Controls
Inherits:

Control

Propiedades

Descripción detallada

WeekNumberColumn presenta los números de semana en una columna. Los números de semana se calculan para un month y un year dados, utilizando el locale especificado.

Columna de números de semana

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

WeekNumberColumn puede utilizarse como control independiente, pero se suele utilizar junto con MonthGrid. Independientemente del caso de uso, el posicionamiento de la columna se deja en manos del usuario.

Columna con el número de la semana en el calendario

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
    }
}

La apariencia visual de WeekNumberColumn puede cambiarse implementando un custom delegate.

Véase también MonthGrid y DayOfWeekRow.

Documentación de propiedades

delegate : Component

Esta propiedad contiene el elemento delegado que visualiza cada número de semana.

Además de la propiedad index, una lista de roles de datos del modelo están disponibles en el contexto de cada delegado:

model.weekNumber: intEl número de semana

El siguiente fragmento presenta la implementación por defecto del delegado de elementos. Puede utilizarse como punto de partida para implementar delegados personalizados.

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

    required property int weekNumber
}

WeekNumberColumn no se apropia del delegado.

month : int

Esta propiedad contiene el número del mes para el que se calculan los números de semana. El valor por defecto es el mes actual.

Los tipos relacionados con el calendario en Qt Quick Controls utilizan números de mes basados en 0, como los objetos Date de JavaScript. Sin embargo, esto difiere de QDate, donde los meses se numeran empezando por 1.

Para evitar confusiones, puede utilizar los siguientes valores de enumeración:

ConstanteDescripción
Calendar.JanuaryEnero (0)
Calendar.FebruaryFebrero (1)
Calendar.MarchMarzo (2)
Calendar.AprilAbril (3)
Calendar.MayMayo (4)
Calendar.JuneJunio (5)
Calendar.JulyJulio (6)
Calendar.AugustAgosto (7)
Calendar.Septemberseptiembre (8)
Calendar.Octoberoctubre (9)
Calendar.Novembernoviembre (10)
Calendar.DecemberDiciembre (11)

Ver también Calendar.

year : int

Esta propiedad contiene el número del año para el que se calculan los números de semana.

El valor debe estar en el rango de -271820 a 275759. El valor por defecto es el año actual.

© 2026 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.