En esta página

QFontVariableAxis Class

La clase QFontVariableAxis representa un eje variable en una fuente. Más...

Cabecera: #include <QFontVariableAxis>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Desde: Qt 6.9

Nota: Todas las funciones de esta clase son reentrantes.

Propiedades

  • name : const QString
  • tag : const QByteArray

Funciones públicas

QFontVariableAxis(const QFontVariableAxis &axis)
~QFontVariableAxis()
qreal defaultValue() const
qreal maximumValue() const
qreal minimumValue() const
QString name() const
void setDefaultValue(qreal defaultValue)
void setMaximumValue(qreal maximumValue)
void setMinimumValue(qreal minimumValue)
void setName(const QString &name)
void setTag(QFont::Tag tag)
QFont::Tag tag() const
QFontVariableAxis &operator=(const QFontVariableAxis &axis)

Descripción detallada

Las fuentes variables proporcionan una forma de almacenar múltiples variaciones (con diferentes pesos, anchos o estilos) en el mismo archivo de fuente. Las variaciones se dan como valores en coma flotante para un conjunto predefinido de parámetros, llamados "ejes variables".

Las parametrizaciones específicas (conjuntos de valores para los ejes de una fuente) pueden seleccionarse utilizando las propiedades en QFont, igual que con las subfamilias tradicionales que se definen como archivos de fuentes independientes. Pero con las fuentes variables, se pueden proporcionar valores arbitrarios para cada eje para obtener una personalización detallada de la apariencia de la fuente.

QFontVariableAxis contiene información de un eje. Utilice QFontInfo::variableAxes() para recuperar una lista de los ejes variables definidos para una fuente determinada. Se pueden proporcionar valores específicos para un eje utilizando QFont::setVariableAxis() y pasando el valor tag().

Nota: En Windows, los ejes variables no están soportados si se utiliza el backend opcional de fuentes GDI.

Documentación de propiedades

[read-only] defaultValue : const qreal

Esta propiedad contiene el valor por defecto del eje

Es el valor que tendrá el eje si no se ha proporcionado ninguno en la consulta QFont.

Funciones de acceso:

qreal defaultValue() const

Véase también minimumValue() y maximumValue().

[read-only] maximumValue : const qreal

Esta propiedad contiene el valor máximo del eje

No es posible establecer un valor superior.

Funciones de acceso:

qreal maximumValue() const

Véase también minimumValue() y defaultValue().

[read-only] minimumValue : const qreal

Esta propiedad contiene el valor mínimo del eje.

Funciones de acceso:

qreal minimumValue() const

[read-only] name : const QString

Esta propiedad contiene el nombre del eje, si lo proporciona la fuente

Funciones de acceso:

QString name() const

Véase también tag().

[read-only] tag : const QByteArray

Esta propiedad contiene la etiqueta del eje

Se trata de una secuencia de cuatro caracteres que identifica el eje. Algunas etiquetas tienen significados estandarizados, como "wght" (peso) y "wdth" (anchura), pero cualquier secuencia de cuatro caracteres latinos-1 es una etiqueta válida. Por convención, los ejes no estándar/personalizados se indican con etiquetas en mayúsculas.

Véase también QFont::setVariableAxis() y name().

Documentación de las funciones miembro

QFontVariableAxis::QFontVariableAxis(const QFontVariableAxis &axis)

Crea un objeto QFontVariableAxis que es una copia del dado axis.

Véase también operator=().

[noexcept] QFontVariableAxis::~QFontVariableAxis()

Destruye este objeto QFontVariableAxis.

qreal QFontVariableAxis::defaultValue() const

Devuelve el valor por defecto del eje. Este es el valor que tendrá el eje si no se ha proporcionado ninguno en la consulta QFont.

Nota: Función Getter para la propiedad defaultValue.

Véase también setDefaultValue(), minimumValue(), y maximumValue().

qreal QFontVariableAxis::maximumValue() const

Devuelve el valor máximo del eje. No es posible ajustar el eje a un valor superior.

Nota: Función Getter para la propiedad maximumValue.

Véase también setMaximumValue(), minimumValue(), y defaultValue().

qreal QFontVariableAxis::minimumValue() const

Devuelve el valor mínimo del eje. No es posible ajustar el eje a un valor inferior.

Nota: Función Getter para la propiedad minimumValue.

Véase también setMinimumValue(), maximumValue(), y defaultValue().

QString QFontVariableAxis::name() const

Devuelve el nombre del eje, si es proporcionado por la fuente.

Nota: Función Getter para la propiedad nombre.

Véase también setName() y tag().

void QFontVariableAxis::setDefaultValue(qreal defaultValue)

Establece el valor por defecto de este QFontVariableAxis a defaultValue.

Nota: Típicamente, no habrá necesidad de llamar a esta función ya que no afectará a la fuente en sí, sólo a esta representación en particular.

Véase también defaultValue().

void QFontVariableAxis::setMaximumValue(qreal maximumValue)

Establece el valor máximo de este QFontVariableAxis a maximumValue.

Nota: Típicamente, no habrá necesidad de llamar a esta función ya que no afectará a la fuente en sí, sólo a esta representación en particular.

Véase también maximumValue().

void QFontVariableAxis::setMinimumValue(qreal minimumValue)

Establece el valor mínimo de este QFontVariableAxis a minimumValue.

Nota: Típicamente, no habrá necesidad de llamar a esta función ya que no afectará a la fuente en sí, sólo a esta representación en particular.

Véase también minimumValue().

void QFontVariableAxis::setName(const QString &name)

Establece el nombre de este QFontVariableAxis a name.

Nota: Típicamente, no habrá necesidad de llamar a esta función ya que no afectará a la fuente en sí, sólo a esta representación en particular.

Véase también name().

void QFontVariableAxis::setTag(QFont::Tag tag)

Establece la etiqueta de QFontVariableAxis a tag.

Nota: Típicamente, no habrá necesidad de llamar a esta función ya que no afectará a la fuente en sí, sólo a esta representación en particular.

Véase también tag().

QFont::Tag QFontVariableAxis::tag() const

Devuelve la etiqueta del eje. Se trata de una secuencia de cuatro caracteres que identifica el eje. Algunas etiquetas tienen significados estandarizados, como "wght" (peso) y "wdth" (anchura), pero cualquier secuencia de cuatro caracteres latinos-1 es una etiqueta válida. Por convención, los ejes no estándar/personalizados se indican con etiquetas en mayúsculas.

Véase también setTag(), QFont::setVariableAxis() y name().

QFontVariableAxis &QFontVariableAxis::operator=(const QFontVariableAxis &axis)

Asigna el axis dado a este QFontVariableAxis.

Véase también QFontVariableAxis().

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