En esta página

QFontVariableAxis Class

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

Encabezado: #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(QFontVariableAxis &&other)
~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 permiten almacenar múltiples variaciones (con diferentes grosores, anchos o estilos) en un mismo archivo de fuente. Las variaciones se expresan como valores de coma flotante para un conjunto predefinido de parámetros, denominados «ejes variables».

Las parametrizaciones específicas (conjuntos de valores para los ejes de una fuente) pueden seleccionarse mediante las propiedades de ` QFont`, al igual que con las subfamilias tradicionales que se definen como archivos de fuente independientes. Sin embargo, con las fuentes variables, se pueden proporcionar valores arbitrarios para cada eje con el fin de lograr una personalización más detallada del aspecto de la fuente.

QFontVariableAxis contiene información sobre un eje. Utiliza QFontInfo::variableAxes() para obtener 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 objeto tag().

Nota: En Windows, los ejes variables no son compatibles si se utiliza el backend de fuentes GDI opcional.

Documentación de propiedades

[read-only] defaultValue : const qreal

Esta propiedad contiene el valor por defecto del eje

Este es el valor que tendrá el eje si no se ha especificado ninguno en la consulta QFont.

Funciones de Access:

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 se admite establecer el eje en un valor superior a este.

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 Access:

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 Latin-1 es una etiqueta válida. Por convención, los ejes no estándar o personalizados se indican con etiquetas escritas íntegramente en mayúsculas.

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

Documentación de las funciones de miembro

QFontVariableAxis::QFontVariableAxis(const QFontVariableAxis &axis)

Crea un objeto `QFontVariableAxis` que es una copia del objeto ` axis` especificado.

Véase también operator=().

[constexpr noexcept default] QFontVariableAxis::QFontVariableAxis(QFontVariableAxis &&other)

Crea una instancia de ` QFontVariableAxis` mediante la construcción «move».

[noexcept] QFontVariableAxis::~QFontVariableAxis()

Elimina este objeto de tipo « QFontVariableAxis ».

qreal QFontVariableAxis::defaultValue() const

Devuelve el valor por defecto del eje. Se trata del valor que tendrá el eje si no se ha especificado ninguno en la consulta « QFont ».

Nota: Funcióngetter para la propiedad defaultValue.

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

qreal QFontVariableAxis::maximumValue() const

Devuelve el valor máximo del eje. No se admite establecer el eje en un valor superior a este.

Nota: Funcióngetter para la propiedad maximumValue.

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

qreal QFontVariableAxis::minimumValue() const

Devuelve el valor mínimo del eje. No se admite establecer el eje en un valor inferior a este.

Nota: Funcióngetter para la propiedad minimumValue.

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

QString QFontVariableAxis::name() const

Devuelve el nombre del eje, si la fuente lo proporciona.

Nota: Funcióngetter para la propiedad «name».

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

void QFontVariableAxis::setDefaultValue(qreal defaultValue)

Establece el valor por defecto de este « QFontVariableAxis » en « defaultValue ».

Nota: Normalmente , no será necesario llamar a esta función, ya que no afectará a la fuente en sí, sino solo a esta representación concreta.

Véase también defaultValue().

void QFontVariableAxis::setMaximumValue(qreal maximumValue)

Establece el valor máximo de este « QFontVariableAxis » en « maximumValue ».

Nota: Normalmente , no será necesario llamar a esta función, ya que no afectará a la fuente en sí, sino únicamente a esta representación concreta.

Véase también maximumValue().

void QFontVariableAxis::setMinimumValue(qreal minimumValue)

Establece el valor mínimo de este ` QFontVariableAxis ` en ` minimumValue`.

Nota: Normalmente , no será necesario llamar a esta función, ya que no afectará a la fuente en sí, sino solo a esta representación concreta.

Véase también minimumValue().

void QFontVariableAxis::setName(const QString &name)

Establece el nombre de este « QFontVariableAxis » como « name ».

Nota: Normalmente , no será necesario llamar a esta función, ya que no afectará a la fuente en sí, sino solo a esta representación concreta.

Véase también name().

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

Establece la etiqueta de « QFontVariableAxis » en « tag ».

Nota: Normalmente , no será necesario llamar a esta función, ya que no afectará a la fuente en sí, sino solo a esta representación concreta.

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 Latin-1 es una etiqueta válida. Por convención, los ejes no estándar o 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 dominio axis 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.