En esta página

WeekNumberColumn QML Type

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

Import Statement: import QtQuick.Controls
Inherits:

Control

Propiedades

Descripción detallada

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

Columna «Número de semana» que muestra los números de semana

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

WeekNumberColumn puede utilizarse como control independiente, pero lo más habitual es utilizarlo junto con MonthGrid. Independientemente del caso de uso, la ubicación de la columna queda a elección del usuario.

Columna «Número de semana» en el diseño del 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
    }
}

El aspecto visual de WeekNumberColumn se puede modificar implementando un custom delegate.

Véase también « MonthGrid » y « DayOfWeekRow ».

Documentación de propiedades

delegate : Component

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

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

model.weekNumber: intEl número de semana

El siguiente fragmento de código muestra la implementación predeterminada del delegado de elemento. Se puede utilizar 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 asume la propiedad 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 los controles deQt Quick utilizan números de mes basados en 0, al igual que los objetos Date de JavaScript. Sin embargo, esto difiere de QDate, donde los meses se numeran a partir del 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)

Véase 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 comprendido entre -271820 y 275759. El valor predeterminado 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.