Sur cette page

WeekNumberColumn QML Type

Une colonne de numéros de semaine. Plus d'informations...

Import Statement: import QtQuick.Controls
Inherits:

Control

Propriétés

Description détaillée

WeekNumberColumn présente les numéros de semaine dans une colonne. Les numéros de semaine sont calculés pour un month et un year donnés, en utilisant le locale spécifié.

Colonne des numéros de semaine affichant les numéros de semaine

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

WeekNumberColumn peut être utilisé comme un contrôle autonome, mais il est le plus souvent utilisé en conjonction avec MonthGrid. Quel que soit le cas d'utilisation, le positionnement de la colonne est laissé à l'appréciation de l'utilisateur.

Colonne du numéro de semaine dans la présentation du calendrier

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

L'apparence visuelle de WeekNumberColumn peut être modifiée par l'implémentation d'un contrôle custom delegate.

Voir également MonthGrid et DayOfWeekRow.

Documentation sur les propriétés

delegate : Component

Cette propriété contient le délégué de l'élément qui visualise chaque numéro de semaine.

Outre la propriété index, une liste de rôles de données de modèle est disponible dans le contexte de chaque délégué :

model.weekNumber: intLe numéro de la semaine

L'extrait suivant présente l'implémentation par défaut du délégué item. Il peut être utilisé comme point de départ pour la mise en œuvre de délégués personnalisés.

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

    required property int weekNumber
}

WeekNumberColumn n'est pas propriétaire du délégué.

month : int

Cette propriété indique le numéro du mois pour lequel les numéros de semaine sont calculés. La valeur par défaut est le mois en cours.

Les types liés au calendrier dans Qt Quick Controls utilisent des numéros de mois basés sur 0, comme les objets JavaScript Date. Toutefois, cela diffère de QDate, où les mois sont numérotés à partir de 1.

Pour éviter toute confusion, vous pouvez utiliser les valeurs d'énumération suivantes :

ConstanteDescription
Calendar.JanuaryJanvier (0)
Calendar.FebruaryFévrier (1)
Calendar.Marchmars (2)
Calendar.AprilAvril (3)
Calendar.MayMai (4)
Calendar.JuneJuin (5)
Calendar.JulyJuillet (6)
Calendar.AugustAoût (7)
Calendar.SeptemberSeptembre (8)
Calendar.OctoberOctobre (9)
Calendar.NovemberNovembre (10)
Calendar.DecemberDécembre (11)

Voir aussi Calendar.

year : int

Cette propriété contient le numéro de l'année pour laquelle les numéros de semaine sont calculés.

La valeur doit être comprise entre -271820 et 275759. La valeur par défaut est l'année en cours.

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