Auf dieser Seite

WeekNumberColumn QML Type

Eine Spalte mit Wochennummern. Mehr...

Import Statement: import QtQuick.Controls
Inherits:

Control

Eigenschaften

Ausführliche Beschreibung

„WeekNumberColumn“ stellt Wochennummern in einer Spalte dar. Die Wochennummern werden für ein gegebenes „ month “ und „ year “ unter Verwendung des angegebenen „ locale “ berechnet.

Spalte „Wochennummer“, in der die Wochennummern angezeigt werden

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

„WeekNumberColumn“ kann als eigenständiges Steuerelement verwendet werden, wird jedoch meist in Verbindung mit „ MonthGrid “ eingesetzt. Unabhängig vom Anwendungsfall bleibt die Positionierung der Spalte dem Benutzer überlassen.

Spalte „Wochennummer“ im Kalenderlayout

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

Das Erscheinungsbild von „WeekNumberColumn“ lässt sich durch die Implementierung eines „ custom delegate “ ändern.

Siehe auch „ MonthGrid “ und „ DayOfWeekRow “.

Dokumentation der Eigenschaften

delegate : Component

Diese Eigenschaft enthält den Element-Delegaten, der die jeweilige Wochennummer visualisiert.

Zusätzlich zur Eigenschaft „ index “ steht im Kontext jedes Delegaten eine Liste von Modelldatenrollen zur Verfügung:

model.weekNumber: intDie Wochennummer

Der folgende Codeausschnitt zeigt die Standardimplementierung des Element-Delegaten. Er kann als Ausgangspunkt für die Implementierung benutzerdefinierter Delegaten dienen.

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

    required property int weekNumber
}

WeekNumberColumn übernimmt nicht die Eigentümerschaft des Delegaten.

month : int

Diese Eigenschaft enthält die Nummer des Monats, für den die Wochennummern berechnet werden. Der Standardwert ist der aktuelle Monat.

Kalenderbezogene Typen in Qt Quick Controls verwenden 0-basierte Monatsnummern, ähnlich wie die JavaScript-Date-Objekte. Dies unterscheidet sich jedoch von QDate, wo die Monate beginnend mit 1 nummeriert werden.

Um Verwechslungen zu vermeiden, können Sie die folgenden Aufzählungswerte verwenden:

KonstanteBeschreibung
Calendar.JanuaryJanuar (0)
Calendar.FebruaryFebruar (1)
Calendar.MarchMärz (2)
Calendar.AprilApril (3)
Calendar.MayMai (4)
Calendar.JuneJuni (5)
Calendar.JulyJuli (6)
Calendar.AugustAugust (7)
Calendar.SeptemberSeptember (8)
Calendar.OctoberOktober (9)
Calendar.NovemberNovember (10)
Calendar.DecemberDezember (11)

Siehe auch Calendar.

year : int

Diese Eigenschaft enthält die Jahreszahl, für die die Wochennummern berechnet werden.

Der Wert muss im Bereich von -271820 bis 275759 liegen. Der Standardwert ist das aktuelle Jahr.

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