enumeration QML Value Type

ein benannter Aufzählungswert. Mehr...

Detaillierte Beschreibung

Der Typ enumeration bezieht sich auf einen benannten Aufzählungswert.

Jeder benannte Wert kann als <Type>.<value> bezeichnet werden. Zum Beispiel hat der Typ Text einen Aufzählungswert AlignRight:

Text { horizontalAlignment: Text.AlignRight }

(Aus Gründen der Abwärtskompatibilität kann der Aufzählungswert auch als String angegeben werden, z. B. "AlignRight". Diese Form wird für neuen Code nicht empfohlen.)

Bei der Integration mit C++ ist zu beachten, dass jeder enum Wert, der von C++ an QML übergeben wird, automatisch in einen enumeration Wert umgewandelt wird und umgekehrt.

Dieser Wertetyp wird von der Sprache QML bereitgestellt. Einige Aufzählungswerte werden durch den QtQuick Import bereitgestellt.

Verwendung des Aufzählungstyps in QML

Der enumeration Typ ist eine Darstellung eines C++ enum Typs. Es ist nicht möglich, in QML selbst auf den Typ enumeration zu verweisen; stattdessen können die Typen int oder var verwendet werden, wenn von QML-Code aus auf enumeration -Werte verwiesen wird.

Ein Beispiel:

import QtQuick 2.0

Item {
    // refer to Text.AlignRight using an int type
    property int enumValue: textItem.horizontalAlignment

    signal valueEmitted(int someValue)

    Text {
        id: textItem
        horizontalAlignment: Text.AlignRight
    }

    // emit valueEmitted() signal, which expects an int, with Text.AlignRight
    Component.onCompleted: valueEmitted(Text.AlignRight)
}

Siehe auch QML Value Types und Enumeration Attributes.

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