Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

QFont::Tag Struct

struct QFont::Tag

Le type QFont::Tag permet d'accéder aux fonctions avancées des polices de caractères. Plus d'informations...

Cette structure a été introduite dans Qt 6.7.

Fonctions publiques

Tag()
Tag(const char (&)[N] str)
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'une valeur entière de 32 bits. Ce type représente une telle balise d'une manière sûre. Il peut être construit à partir d'un littéral de chaîne de quatre caractères sur 8 bits ou d'une valeur entière correspondante sur 32 bits. L'utilisation d'un littéral de chaîne plus court ou plus long 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 ou d'une chaîne de 32 bits, et renvoient une adresse std::nullopt si l'entrée n'est pas valide.

Voir aussi QFont::setFeature() et QFont::featureTags().

Documentation des fonctions membres

[constexpr noexcept] Tag::Tag()

Constructeur par défaut, produisant une balise invalide.

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

Construit 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 aussi fromString() et fromValue().

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

Renvoie une balise construite à partir de la chaîne de caractères contenue dans view. La chaîne doit comporter exactement quatre caractères.

Retourne std::nullopt si l'entrée ne contient pas quatre caractères ou si la balise produite n'est pas valide.

Voir aussi isValid() et fromValue().

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

Renvoie une balise construite à partir de value, ou std::nullopt si la balise produite n'est pas valide.

Voir aussi isValid().

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

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

Voir aussi 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().

Non-membres apparentés

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

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

Comparez lhs avec rhs pour l'égalité et l'ordre.

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

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

QDataStream &operator<<(QDataStream &, QFont::Tag)

QDataStream &operator>>(QDataStream &, QFont::Tag &)

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.