Auf dieser Seite

QFont::Tag Struct

struct QFont::Tag

Der Typ „ QFont::Tag “ ermöglicht den Zugriff auf erweiterte Schriftartenfunktionen. Mehr dazu...

Diese Struktur wurde in Qt 6.7 eingeführt.

Öffentliche Funktionen

Tag()
Tag(const char (&str)[N])
bool isValid() const
QByteArray toString() const
quint32 value() const

Statische öffentliche Mitglieder

std::optional<QFont::Tag> fromString(QAnyStringView view)
std::optional<QFont::Tag> fromValue(quint32 value)
Qt::strong_ordering compareThreeWay(const QFont::Tag &lhs, const QFont::Tag &rhs)
bool comparesEqual(const QFont::Tag &lhs, const QFont::Tag &rhs)
size_t qHash(QFont::Tag key, size_t seed = 0)
QDataStream &operator<<(QDataStream &, QFont::Tag)
QDataStream &operator>>(QDataStream &, QFont::Tag &)

Ausführliche Beschreibung

QFont bietet Zugriff auf erweiterte Funktionen bei der Textgestaltung. Eine Funktion wird durch ein Tag definiert, das als vierstellige Zeichenkette oder als 32-Bit-Ganzzahlwert dargestellt werden kann. Dieser Typ repräsentiert ein solches Tag auf typsichere Weise. Er kann aus einem vierstelligen 8-Bit-Zeichenfolgenliteral oder aus einem entsprechenden 32-Bit-Ganzzahlwert konstruiert werden. Die Verwendung eines kürzeren oder längeren Zeichenfolgenliterals führt zu einem Kompilierungsfehler.

QFont font;
// Correct
font.setFeature("frac");

// Wrong - won't compile
font.setFeature("fraction");

// Wrong - will produce runtime warning and fail
font.setFeature(u"fraction"_s);

Die benannten Konstruktoren ermöglichen die Erstellung eines Tags aus einem 32-Bit-Ganzzahl- oder Zeichenfolgenwert und geben bei ungültiger Eingabe einen „ std::nullopt “ zurück.

Siehe auch QFont::setFeature() und QFont::featureTags().

Dokumentation zu den Member-Funktionen

[constexpr noexcept default] Tag::Tag()

Standardkonstruktor, der ein ungültiges Tag erzeugt.

[constexpr noexcept] template <size_t N> Tag::Tag(const char (&str)[N])

Erstellt ein Tag aus einem String-Literal, str. Das Literal muss genau vier Zeichen lang sein.

font.setFeature("frac", 1);

Siehe auch „ fromString()“ und „ fromValue()“.

[static noexcept] std::optional<QFont::Tag> Tag::fromString(QAnyStringView view)

Gibt ein Tag zurück, das aus der Zeichenkette in „ view “ gebildet wurde. Die Zeichenkette muss genau vier Zeichen lang sein.

Gibt „ std::nullopt “ zurück, wenn die Eingabe nicht vier Zeichen lang ist oder wenn das erzeugte Tag ungültig wäre.

Siehe auch „ isValid()“ und „ fromValue()“.

[static constexpr noexcept] std::optional<QFont::Tag> Tag::fromValue(quint32 value)

Gibt ein aus value erstelltes Tag zurück oder std::nullopt, falls das erzeugte Tag ungültig wäre.

Siehe auch isValid().

[constexpr noexcept] bool Tag::isValid() const

Gibt zurück, ob das Tag gültig ist. Ein Tag ist gültig, wenn sein Wert ungleich Null ist.

Siehe auch value(), fromValue() und fromString().

QByteArray Tag::toString() const

Gibt die Zeichenfolgenrepräsentation dieses Tags als Byte-Array zurück.

Siehe auch ` fromString()`.

[constexpr noexcept] quint32 Tag::value() const

Gibt den numerischen Wert dieses Tags zurück.

Siehe auch isValid() und fromValue().

Verwandte Nicht-Mitglieder

[constexpr noexcept] Qt::strong_ordering compareThreeWay(const QFont::Tag &lhs, const QFont::Tag &rhs)

[constexpr noexcept] bool comparesEqual(const QFont::Tag &lhs, const QFont::Tag &rhs)

Vergleichen Sie lhs mit rhs hinsichtlich Gleichheit und Reihenfolge.

[constexpr noexcept] size_t qHash(QFont::Tag key, size_t seed = 0)

Gibt den Hashwert für key zurück, wobei seed als Startwert für die Berechnung verwendet wird.

Datenstromoperatoren für „ QFont::Tag “.

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