Sur cette page

QFont::Tag Struct

struct QFont::Tag

Le type « QFont::Tag » permet d'accéder à des fonctionnalités avancées liées aux polices. En savoir plus…

Cette structure a été introduite dans Qt 6.7.

Fonctions publiques

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

Membres publics statiques

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 &)

Description détaillée

QFont Permet d’accéder à des fonctionnalités avancées lors de la mise en forme du texte. Une fonctionnalité est définie par une balise, qui peut être représentée sous la forme d’une chaîne de quatre caractères ou d’un entier de 32 bits. Ce type représente une telle balise de manière sécurisée au niveau du type. Il peut être construit à partir d’une chaîne littérale de quatre caractères (8 bits) ou d’une valeur entière de 32 bits correspondante. L’utilisation d’une chaîne littérale plus courte ou plus longue entraînera une erreur de compilation.

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);

Les constructeurs nommés permettent de créer une balise à partir d’un entier de 32 bits ou d’une chaîne de caractères, et renvoient une exception ` std::nullopt ` lorsque l’entrée n’est pas valide.

Voir également ` QFont::setFeature()` et ` QFont::featureTags()`.

Documentation des fonctions membres

[constexpr noexcept default] Tag::Tag()

Constructeur par défaut, générant une balise non valide.

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

Crée une balise à partir d'une chaîne littérale, str. La chaîne littérale doit comporter exactement quatre caractères.

font.setFeature("frac", 1);

Voir également fromString() et fromValue().

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

Renvoie une balise générée à partir de la chaîne de caractères indiquée dans view. La chaîne doit comporter exactement quatre caractères.

Renvoie « std::nullopt » si la chaîne d'entrée ne comporte pas quatre caractères, ou si la balise générée serait invalide.

Voir aussi isValid() et fromValue().

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

Renvoie une balise générée à partir de value, ou std::nullopt si la balise générée n'est pas valide.

Voir également isValid().

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

Indique si la balise est valide. Une balise est valide si sa valeur est différente de zéro.

Voir également value(), fromValue() et fromString().

QByteArray Tag::toString() const

Renvoie la représentation sous forme de chaîne de caractères de cette balise sous la forme d'un tableau d'octets.

Voir aussi fromString().

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

Renvoie la valeur numérique de cette balise.

Voir également isValid() et fromValue().

Éléments non membres associés

[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)

Comparez lhs et rhs pour vérifier l'égalité et l'ordre.

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

Renvoie la valeur de hachage de key, en utilisant seed comme graine pour le calcul.

Opérateurs de flux de données pour 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.