Back to Qt.io
Contact Us Blog Download Qt
En esta página

QFont::Tag Struct

struct QFont::Tag

El tipo QFont::Tag proporciona acceso a funciones de fuente avanzadas. Más...

Esta estructura se introdujo en Qt 6.7.

Funciones Públicas

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

Miembros públicos estáticos

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

Descripción detallada

QFont proporciona acceso a funciones avanzadas para dar forma al texto. Una función se define mediante una etiqueta, que puede representarse como una cadena de cuatro caracteres o como un valor entero de 32 bits. Este tipo representa una etiqueta de este tipo de forma segura. Puede construirse a partir de una cadena literal de cuatro caracteres y 8 bits, o de un valor entero de 32 bits correspondiente. Si se utiliza un literal de cadena más corto o más largo, se producirá un error de compilación.

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

Los constructores con nombre permiten crear una etiqueta a partir de un valor entero o de cadena de 32 bits, y devolverán un std::nullopt cuando la entrada no sea válida.

Véase también QFont::setFeature() y QFont::featureTags().

Documentación de las funciones miembro

[constexpr noexcept] Tag::Tag()

Constructor por defecto, produce una etiqueta inválida.

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

Construye una etiqueta a partir de una cadena literal, str. El literal debe tener exactamente cuatro caracteres.

font.setFeature("frac", 1);

Véase también fromString() y fromValue().

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

Devuelve una etiqueta construida a partir de la cadena contenida en view. La cadena debe tener exactamente cuatro caracteres.

Devuelve std::nullopt si la entrada no tiene cuatro caracteres, o si la etiqueta producida no es válida.

Véase también isValid() y fromValue().

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

Devuelve una etiqueta construida a partir de value, o std::nullopt si la etiqueta producida no es válida.

Véase también isValid().

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

Devuelve si la etiqueta es válida. Una etiqueta es válida si su valor no es cero.

Véase también value(), fromValue() y fromString().

QByteArray Tag::toString() const

Devuelve la representación de cadena de esta etiqueta como una matriz de bytes.

Véase también fromString().

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

Devuelve el valor numérico de esta etiqueta.

Véase también isValid() y fromValue().

Relacionados No miembros

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

Compara lhs con rhs para igualdad y ordenación.

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

Devuelve el valor hash para key, utilizando seed para sembrar el cálculo.

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

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

Operadores de flujo de datos para 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.