Sur cette page

QFontVariableAxis Class

La classe QFontVariableAxis représente un axe variable dans une police. Plus d'informations...

En-tête : #include <QFontVariableAxis>
CMake : find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake : QT += gui
Depuis : Qt 6.9

Note : Toutes les fonctions de cette classe sont réentrantes.

Propriétés

  • name : const QString
  • tag : const QByteArray

Fonctions publiques

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)

Description détaillée

Les polices variables permettent de stocker plusieurs variations (avec des poids, des largeurs ou des styles différents) dans le même fichier de police. Les variations sont données sous forme de valeurs à virgule flottante pour un ensemble prédéfini de paramètres, appelés "axes variables".

Des paramétrages spécifiques (ensembles de valeurs pour les axes d'une police) peuvent être sélectionnés à l'aide des propriétés de QFont, comme pour les sous-familles traditionnelles qui sont définies comme des fichiers de police autonomes. Mais avec les polices variables, des valeurs arbitraires peuvent être fournies pour chaque axe afin de personnaliser finement l'apparence de la police.

QFontVariableAxis contient des informations sur un axe. Utilisez QFontInfo::variableAxes() pour récupérer la liste des axes variables définis pour une police donnée. Des valeurs spécifiques peuvent être fournies pour un axe en utilisant QFont::setVariableAxis() et en transmettant tag().

Remarque : sous Windows, les axes variables ne sont pas pris en charge si le backend de police GDI optionnel est utilisé.

Documentation sur les propriétés

[read-only] defaultValue : const qreal

Cette propriété contient la valeur par défaut de l'axe

Il s'agit de la valeur de l'axe si aucune valeur n'a été fournie dans la requête QFont.

Fonctions d'accès :

qreal defaultValue() const

Voir également minimumValue() et maximumValue().

[read-only] maximumValue : const qreal

Cette propriété contient la valeur maximale de l'axe

Il n'est pas possible de régler l'axe sur une valeur supérieure à celle-ci.

Fonctions d'accès :

qreal maximumValue() const

Voir également minimumValue() et defaultValue().

[read-only] minimumValue : const qreal

Cette propriété contient la valeur minimale de l'axe.

Fonctions d'accès :

qreal minimumValue() const

[read-only] name : const QString

Cette propriété contient le nom de l'axe, s'il est fourni par la police.

Access :

QString name() const

Voir aussi tag().

[read-only] tag : const QByteArray

Cette propriété contient la balise de l'axe

Il s'agit d'une séquence de quatre caractères qui identifie l'axe. Certaines balises ont une signification normalisée, comme "wght" (poids) et "wdth" (largeur), mais toute séquence de quatre caractères latins-1 est une balise valide. Par convention, les axes non standard/customisés sont désignés par des balises en majuscules.

Voir également QFont::setVariableAxis() et name().

Documentation des fonctions membres

QFontVariableAxis::QFontVariableAxis(const QFontVariableAxis &axis)

Crée un objet QFontVariableAxis qui est une copie de l'objet axis.

Voir aussi operator=().

[noexcept] QFontVariableAxis::~QFontVariableAxis()

Détruit cet objet QFontVariableAxis.

qreal QFontVariableAxis::defaultValue() const

Renvoie la valeur par défaut de l'axe. Il s'agit de la valeur de l'axe si aucune valeur n'a été fournie dans la requête QFont.

Remarque : fonction Getter pour la propriété defaultValue.

Voir aussi setDefaultValue(), minimumValue() et maximumValue().

qreal QFontVariableAxis::maximumValue() const

Renvoie la valeur maximale de l'axe. Le réglage de l'axe à une valeur supérieure à celle-ci n'est pas pris en charge.

Remarque : fonction Getter pour la propriété maximumValue.

Voir aussi setMaximumValue(), minimumValue() et defaultValue().

qreal QFontVariableAxis::minimumValue() const

Renvoie la valeur minimale de l'axe. Il n'est pas possible de régler l'axe sur une valeur inférieure à cette valeur.

Remarque : fonction Getter pour la propriété minimumValue.

Voir aussi setMinimumValue(), maximumValue() et defaultValue().

QString QFontVariableAxis::name() const

Renvoie le nom de l'axe, s'il est fourni par la police.

Note : Fonction Getter pour le nom de la propriété.

Voir aussi setName() et tag().

void QFontVariableAxis::setDefaultValue(qreal defaultValue)

Définit la valeur par défaut de cette QFontVariableAxis à defaultValue.

Remarque : en règle générale, il n'est pas nécessaire d'appeler cette fonction, car elle n'affecte pas la police elle-même, mais uniquement cette représentation particulière.

Voir aussi defaultValue().

void QFontVariableAxis::setMaximumValue(qreal maximumValue)

Fixe la valeur maximale de cette QFontVariableAxis à maximumValue.

Remarque : en règle générale, il n'est pas nécessaire d'appeler cette fonction, car elle n'affecte pas la police elle-même, mais uniquement cette représentation particulière.

Voir également maximumValue().

void QFontVariableAxis::setMinimumValue(qreal minimumValue)

Fixe la valeur minimale de ce site QFontVariableAxis à minimumValue.

Remarque : en règle générale, il n'est pas nécessaire d'appeler cette fonction, car elle n'affecte pas la police elle-même, mais uniquement cette représentation particulière.

Voir également minimumValue().

void QFontVariableAxis::setName(const QString &name)

Définit le nom de cette QFontVariableAxis à name.

Remarque : en règle générale, il n'est pas nécessaire d'appeler cette fonction, car elle n'affecte pas la police elle-même, mais uniquement cette représentation particulière.

Voir aussi name().

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

Définit la balise de QFontVariableAxis à tag.

Remarque : en règle générale, il n'est pas nécessaire d'appeler cette fonction, car elle n'affecte pas la police elle-même, mais uniquement cette représentation particulière.

Voir aussi tag().

QFont::Tag QFontVariableAxis::tag() const

Renvoie la balise de l'axe. Il s'agit d'une séquence de quatre caractères qui identifie l'axe. Certaines étiquettes ont une signification normalisée, comme "wght" (poids) et "wdth" (largeur), mais toute séquence de quatre caractères latins-1 est une étiquette valide. Par convention, les axes non standard/customisés sont désignés par des balises en majuscules.

Voir aussi setTag(), QFont::setVariableAxis(), et name().

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

Affecte le site axis à ce site QFontVariableAxis.

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