WeekNumberColumn QML Type

Eine Spalte mit Wochennummern. Mehr...

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

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

delegate : Component
month : int
year : int

Ausführliche Beschreibung

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

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

WeekNumberColumn kann als eigenständiges Steuerelement verwendet werden, wird aber am häufigsten in Verbindung mit MonthGrid eingesetzt. Unabhängig vom Anwendungsfall ist die Positionierung der Spalte dem Benutzer überlassen.

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 visuelle Erscheinungsbild von WeekNumberColumn kann durch die Implementierung eines custom delegate geändert werden.

Siehe auch MonthGrid und DayOfWeekRow.

Eigenschaft Dokumentation

delegate : Component

Diese Eigenschaft enthält den Elementdelegaten, der jede Wochennummer visualisiert.

Zusätzlich zu der index Eigenschaft, eine Liste von Modelldatenrollen sind im Kontext jedes Delegaten verfügbar:

model.weekNumber: int

Die Wochennummer

Das folgende Snippet zeigt die Standardimplementierung des Item-Delegaten. Es kann als Ausgangspunkt für die Implementierung von benutzerdefinierten Delegaten verwendet werden.

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

    required property int weekNumber
}

month : int

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

Das Qt Quick Kalendermodul verwendet 0-basierte Monatsnummern, um mit dem JavaScript-Datums-Typ, der von der QML-Sprache verwendet wird, konsistent zu sein. Das bedeutet, dass Date::getMonth() unverändert an die Methoden übergeben werden kann. Beim direkten Umgang mit Monatszahlen wird dringend empfohlen, die folgenden Aufzählungswerte zu verwenden, um Verwirrung zu vermeiden.

Konstante	Beschreibung
`Calendar.January`	Januar (0)
`Calendar.February`	Februar (1)
`Calendar.March`	März (2)
`Calendar.April`	April (3)
`Calendar.May`	Mai (4)
`Calendar.June`	Juni (5)
`Calendar.July`	Juli (6)
`Calendar.August`	August (7)
`Calendar.September`	September (8)
`Calendar.October`	Oktober (9)
`Calendar.November`	November (10)
`Calendar.December`	Dezember (11)

Siehe auch Calendar.

year : int

Diese Eigenschaft enthält die Nummer des Jahres, für das die Wochennummern berechnet werden.

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

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