QFont Class
La classe QFont spécifie une requête pour une police utilisée pour dessiner du texte. Plus d'informations...
| En-tête : | #include <QFont> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
- Liste de tous les membres, y compris les membres hérités
- Membres dépréciés
- QFont fait partie de Painting Classes, Implicitly Shared Classes, et Rich Text Processing APIs.
Remarque : toutes les fonctions de cette classe sont réentrantes.
Types publics
(since 6.7) struct | Tag |
| enum | Capitalization { MixedCase, AllUppercase, AllLowercase, SmallCaps, Capitalize } |
| enum | HintingPreference { PreferDefaultHinting, PreferNoHinting, PreferVerticalHinting, PreferFullHinting } |
| enum | SpacingType { PercentageSpacing, AbsoluteSpacing } |
| enum | Stretch { AnyStretch, UltraCondensed, ExtraCondensed, Condensed, SemiCondensed, …, UltraExpanded } |
| enum | Style { StyleNormal, StyleItalic, StyleOblique } |
| enum | StyleHint { AnyStyle, SansSerif, Helvetica, Serif, Times, …, System } |
| enum | StyleStrategy { PreferDefault, PreferBitmap, PreferDevice, PreferOutline, ForceOutline, …, PreferQuality } |
| enum | Weight { Thin, ExtraLight, Light, Normal, Medium, …, Black } |
Fonctions publiques
| QFont() | |
| QFont(const QFont &font, const QPaintDevice *pd) | |
| QFont(const QString &family, int pointSize = -1, int weight = -1, bool italic = false) | |
| QFont(const QStringList &families, int pointSize = -1, int weight = -1, bool italic = false) | |
| QFont(const QFont &font) | |
| ~QFont() | |
| bool | bold() const |
| QFont::Capitalization | capitalization() const |
(since 6.7) void | clearFeatures() |
(since 6.7) void | clearVariableAxes() |
| QString | defaultFamily() const |
| bool | exactMatch() const |
| QStringList | families() const |
| QString | family() const |
(since 6.7) QList<QFont::Tag> | featureTags() const |
(since 6.7) quint32 | featureValue(QFont::Tag tag) const |
| bool | fixedPitch() const |
| bool | fromString(const QString &descrip) |
| QFont::HintingPreference | hintingPreference() const |
| bool | isCopyOf(const QFont &f) const |
(since 6.7) bool | isFeatureSet(QFont::Tag tag) const |
(since 6.7) bool | isVariableAxisSet(QFont::Tag tag) const |
| bool | italic() const |
| bool | kerning() const |
| QString | key() const |
| qreal | letterSpacing() const |
| QFont::SpacingType | letterSpacingType() const |
| bool | overline() const |
| int | pixelSize() const |
| int | pointSize() const |
| qreal | pointSizeF() const |
| QFont | resolve(const QFont &other) const |
| void | setBold(bool enable) |
| void | setCapitalization(QFont::Capitalization caps) |
| void | setFamilies(const QStringList &families) |
| void | setFamily(const QString &family) |
(since 6.7) void | setFeature(QFont::Tag tag, quint32 value) |
| void | setFixedPitch(bool enable) |
| void | setHintingPreference(QFont::HintingPreference hintingPreference) |
| void | setItalic(bool enable) |
| void | setKerning(bool enable) |
| void | setLetterSpacing(QFont::SpacingType type, qreal spacing) |
| void | setOverline(bool enable) |
| void | setPixelSize(int pixelSize) |
| void | setPointSize(int pointSize) |
| void | setPointSizeF(qreal pointSize) |
| void | setStretch(int factor) |
| void | setStrikeOut(bool enable) |
| void | setStyle(QFont::Style style) |
| void | setStyleHint(QFont::StyleHint hint, QFont::StyleStrategy strategy = PreferDefault) |
| void | setStyleName(const QString &styleName) |
| void | setStyleStrategy(QFont::StyleStrategy s) |
| void | setUnderline(bool enable) |
(since 6.7) void | setVariableAxis(QFont::Tag tag, float value) |
| void | setWeight(QFont::Weight weight) |
| void | setWordSpacing(qreal spacing) |
| int | stretch() const |
| bool | strikeOut() const |
| QFont::Style | style() const |
| QFont::StyleHint | styleHint() const |
| QString | styleName() const |
| QFont::StyleStrategy | styleStrategy() const |
| void | swap(QFont &other) |
| QString | toString() const |
| bool | underline() const |
(since 6.7) void | unsetFeature(QFont::Tag tag) |
(since 6.7) void | unsetVariableAxis(QFont::Tag tag) |
(since 6.7) QList<QFont::Tag> | variableAxisTags() const |
(since 6.7) float | variableAxisValue(QFont::Tag tag) const |
| QFont::Weight | weight() const |
| qreal | wordSpacing() const |
| operator QVariant() const | |
| bool | operator!=(const QFont &f) const |
| bool | operator<(const QFont &f) const |
| QFont & | operator=(QFont &&other) |
| QFont & | operator=(const QFont &font) |
| bool | operator==(const QFont &f) const |
Membres publics statiques
| void | insertSubstitution(const QString &familyName, const QString &substituteName) |
| void | insertSubstitutions(const QString &familyName, const QStringList &substituteNames) |
| void | removeSubstitutions(const QString &familyName) |
| QString | substitute(const QString &familyName) |
| QStringList | substitutes(const QString &familyName) |
| QStringList | substitutions() |
Non-membres apparentés
| size_t | qHash(const QFont &key, size_t seed = 0) |
| QDataStream & | operator<<(QDataStream &s, const QFont &font) |
| QDataStream & | operator>>(QDataStream &s, QFont &font) |
Description détaillée
QFont peut être considéré comme une requête pour une ou plusieurs polices sur le système.
Lorsque vous créez un objet QFont, vous spécifiez les différents attributs que vous voulez que la police ait. Qt utilisera la police avec les attributs spécifiés, ou si aucune police correspondante n'existe, Qt utilisera la police installée la plus proche. Les attributs de la police utilisée peuvent être récupérés à partir de l'objet QFontInfo. Si le système de fenêtres fournit une correspondance exacte, exactMatch() renvoie true. Utilisez QFontMetricsF pour obtenir des mesures, par exemple la longueur en pixels d'une chaîne de caractères en utilisant QFontMetrics::horizontalAdvance().
Les attributs qui ne sont pas spécifiquement définis n'affecteront pas l'algorithme de sélection des polices, et les valeurs par défaut seront préférées.
Pour charger une police physique spécifique, généralement représentée par un seul fichier, utilisez plutôt QRawFont.
Notez qu'une instance de QGuiApplication doit exister avant qu'une QFont puisse être utilisée. Vous pouvez définir la police par défaut de l'application avec QGuiApplication::setFont().
Si une police choisie n'inclut pas tous les caractères qui doivent être affichés, QFont essaiera de trouver les caractères dans les polices équivalentes les plus proches. Lorsqu'un QPainter dessine un caractère à partir d'une police, QFont signale s'il possède ou non le caractère ; si ce n'est pas le cas, QPainter dessine un carré non rempli.
Créez des QFonts comme suit :
Les attributs définis dans le constructeur peuvent également être définis ultérieurement, par exemple setFamily(), setPointSize(), setPointSizeF(), setWeight() et setItalic(). Les autres attributs doivent être définis après la construction, par exemple setBold(), setUnderline(), setOverline(), setStrikeOut() et setFixedPitch(). Les objets QFontInfo doivent être créés après que les attributs de la police ont été définis. Un objet QFontInfo ne changera pas, même si vous modifiez les attributs de la police. Les fonctions "get" correspondantes, par exemple family(), pointSize(), etc., renvoient les valeurs qui ont été définies, même si les valeurs utilisées peuvent être différentes. Les valeurs réelles sont disponibles à partir d'un objet QFontInfo.
Si la famille de polices demandée n'est pas disponible, vous pouvez influencer font matching algorithm en choisissant une police particulière QFont::StyleHint et QFont::StyleStrategy avec setStyleHint(). La famille par défaut (correspondant à l'indice de style actuel) est renvoyée par defaultFamily().
Vous pouvez fournir des substitutions pour les noms de familles de polices en utilisant insertSubstitution() et insertSubstitutions(). Les substitutions peuvent être supprimées avec removeSubstitutions(). Utilisez substitute() pour récupérer le premier substitut d'une famille, ou le nom de la famille lui-même s'il n'a pas de substitut. Utilisez substitutes() pour récupérer la liste des substituts d'une famille (qui peut être vide). Après avoir remplacé une police, vous devez déclencher la mise à jour de la police en détruisant et en recréant tous les objets QFont.
Chaque QFont possède un key() que vous pouvez utiliser, par exemple, comme clé dans un cache ou un dictionnaire. Si vous souhaitez stocker les préférences d'un utilisateur en matière de police, vous pouvez utiliser QSettings, en écrivant les informations sur la police avec toString() et en les relisant avec fromString(). Les fonctions operator<<() et operator>>() sont également disponibles, mais elles fonctionnent sur un flux de données.
Il est possible de fixer la hauteur des caractères affichés à l'écran à un nombre spécifié de pixels avec setPixelSize() ; cependant, l'utilisation de setPointSize() a un effet similaire et assure l'indépendance vis-à-vis du périphérique.
Le chargement des polices peut être coûteux, en particulier sur X11. QFont contient de nombreuses optimisations pour rendre la copie des objets QFont rapide et pour mettre en cache les résultats des fonctions lentes du système de fenêtres dont il dépend.
L'algorithme de correspondance des polices fonctionne comme suit :
- Les familles de polices spécifiées (définies par setFamilies()) sont recherchées.
- Si ce n'est pas le cas, une police de remplacement compatible avec le système d'écriture est sélectionnée. L'algorithme de correspondance des polices essaie de trouver la meilleure correspondance pour toutes les propriétés définies dans la QFont. La manière de procéder varie d'une plateforme à l'autre.
- S'il n'existe pas de police sur le système qui puisse prendre en charge le texte, des cases spéciales "caractères manquants" seront affichées à la place.
Remarque : si la police sélectionnée, bien que prenant en charge le système d'écriture en général, manque de glyphes pour un ou plusieurs caractères spécifiques, Qt essaiera de trouver une police de repli pour ce ou ces caractères particuliers. Cette fonctionnalité peut être désactivée à l'aide de la stratégie de style QFont::NoFontMerging.
Sous Windows, une demande de police "Courier" est automatiquement remplacée par "Courier New", une version améliorée de Courier qui permet une mise à l'échelle en douceur. L'ancienne police bitmap "Courier" peut être sélectionnée en définissant la stratégie de style PreferBitmap (voir setStyleStrategy()).
Une fois la police trouvée, les autres attributs sont recherchés par ordre de priorité :
- fixedPitch()
- pointSize() (voir ci-dessous)
- weight()
- style()
Si vous avez une police qui correspond à la famille, même si aucun des autres attributs ne correspond, cette police sera choisie de préférence à une police qui ne correspond pas à la famille mais qui correspond aux autres attributs. En effet, la famille de polices est le critère de recherche dominant.
La taille du point est définie comme correspondante si elle se situe à moins de 20 % de la taille du point demandée. Lorsque plusieurs polices correspondent et ne se distinguent que par la taille du point, la police dont la taille du point est la plus proche de celle demandée sera choisie.
La famille, la taille, le poids et les autres attributs de la police utilisés pour dessiner le texte dépendent de ce qui est disponible pour la famille choisie dans le système de fenêtres. Un objet QFontInfo peut être utilisé pour déterminer les valeurs réelles utilisées pour dessiner le texte.
Exemples :
QFont f("Helvetica");
Si vous avez à la fois un Adobe et un Cronyx Helvetica, vous pouvez obtenir l'un ou l'autre.
QFont f("Helvetica [Cronyx]");
Vous pouvez spécifier la fonderie que vous souhaitez dans le nom de famille. La police f dans l'exemple ci-dessus sera définie sur "Helvetica [Cronyx]".
Pour déterminer les attributs de la police réellement utilisée dans le système de fenêtres, utilisez un objet QFontInfo, par exemple
Pour connaître les métriques des polices, utilisez un objet QFontMetrics, par exemple
QFontMetrics fm(f1); int textWidthInPixels = fm.horizontalAdvance("How many pixels wide is this text?"); int textHeightInPixels = fm.height();
Pour des informations plus générales sur les polices, voir la FAQ comp.fonts. Des informations sur les encodages peuvent être trouvées sur la page UTR17.
Voir aussi QFontMetrics, QFontInfo, et QFontDatabase.
Documentation sur les types de membres
enum QFont::Capitalization
Option de rendu pour le texte auquel cette police s'applique.
| Constante | Valeur | Description |
|---|---|---|
QFont::MixedCase | 0 | Il s'agit de l'option de rendu normal du texte, qui ne modifie pas les majuscules. |
QFont::AllUppercase | 1 | Cette option modifie le texte pour qu'il soit rendu en majuscules. |
QFont::AllLowercase | 2 | Cette option modifie le texte pour qu'il soit rendu en minuscules. |
QFont::SmallCaps | 3 | Cette option modifie le texte pour qu'il soit rendu en petites capitales. |
QFont::Capitalize | 4 | Le texte est rendu avec le premier caractère de chaque mot en majuscule. |
enum QFont::HintingPreference
Cette énumération décrit les différents niveaux d'indication qui peuvent être appliqués aux glyphes pour améliorer la lisibilité sur les écrans où la densité des pixels le justifie.
| Constante | Valeur | Description |
|---|---|---|
QFont::PreferDefaultHinting | 0 | Utilise le niveau d'indication par défaut pour la plate-forme cible. |
QFont::PreferNoHinting | 1 | Si possible, rendre le texte sans indiquer les contours des glyphes. La mise en page du texte sera typographiquement exacte et évolutive, en utilisant les mêmes métriques que celles utilisées, par exemple, lors de l'impression. |
QFont::PreferVerticalHinting | 2 | Si possible, rendez le texte sans indication horizontale, mais alignez les glyphes sur la grille de pixels dans le sens vertical. Le texte apparaîtra plus net sur les écrans dont la densité est trop faible pour permettre un rendu précis des glyphes. Mais comme la métrique horizontale des glyphes n'est pas hachurée, la disposition du texte pourra être adaptée à des dispositifs à plus forte densité (tels que les imprimantes) sans affecter les détails tels que les sauts de ligne. |
QFont::PreferFullHinting | 3 | Si possible, rendez le texte avec des indices dans les directions horizontales et verticales. Le texte sera modifié pour optimiser la lisibilité sur le périphérique cible, mais comme les mesures dépendront de la taille cible du texte, la position des glyphes, des sauts de ligne et d'autres détails typographiques ne seront pas mis à l'échelle, ce qui signifie qu'une disposition de texte peut sembler différente sur des périphériques ayant des densités de pixels différentes. |
Veuillez noter que cette énumération ne décrit qu'une préférence, car la gamme complète des niveaux d'indication n'est pas prise en charge sur toutes les plates-formes prises en charge par Qt. Le tableau suivant détaille l'effet d'une préférence d'indication donnée sur un ensemble sélectionné de plates-formes cibles.
| PreferDefaultHinting | PreferNoHinting | PreferVerticalHinting | PreferFullHinting | |
|---|---|---|---|---|
| Windows et DirectWrite activé dans Qt | Indication complète | Indication verticale | Indication verticale | Indication complète |
| Type libre | Paramètres du système d'exploitation | Aucune indication | Indication verticale (légère) | Indication complète |
| Cocoa sur macOS | Pas d'indication | Pas d'indication | Pas d'indication | Pas d'indication |
enum QFont::SpacingType
| Constante | Valeur | Description de l'espacement |
|---|---|---|
QFont::PercentageSpacing | 0 | Une valeur de 100 maintient l'espacement inchangé ; une valeur de 200 élargit l'espacement après un caractère de la largeur du caractère lui-même. |
QFont::AbsoluteSpacing | 1 | Une valeur positive augmente l'espacement des lettres du nombre de pixels correspondant ; une valeur négative diminue l'espacement. |
enum QFont::Stretch
Valeurs d'étirement prédéfinies qui suivent la convention d'appellation CSS. Plus la valeur est élevée, plus le texte est étiré.
| Constante | Valeur | Description |
|---|---|---|
QFont::AnyStretch (since Qt 5.8) | 0 | 0 Accepte tout étirement correspondant aux autres propriétés QFont |
QFont::UltraCondensed | 50 | 50 |
QFont::ExtraCondensed | 62 | 62 |
QFont::Condensed | 75 | 75 |
QFont::SemiCondensed | 87 | 87 |
QFont::Unstretched | 100 | 100 |
QFont::SemiExpanded | 112 | 112 |
QFont::Expanded | 125 | 125 |
QFont::ExtraExpanded | 150 | 150 |
QFont::UltraExpanded | 200 | 200 |
Voir aussi setStretch() et stretch().
enum QFont::Style
Cette énumération décrit les différents styles de glyphes utilisés pour afficher le texte.
| Constante | Valeur | Description des glyphes |
|---|---|---|
QFont::StyleNormal | 0 | Glyphes normaux utilisés dans les textes non stylisés. |
QFont::StyleItalic | 1 | Glyphes italiques spécifiquement conçus pour représenter du texte en italique. |
QFont::StyleOblique | 2 | Glyphes d'apparence italique basés sur les glyphes non stylisés, mais non adaptés à la représentation de texte en italique. |
Voir aussi Weight.
enum QFont::StyleHint
Les indications de style sont utilisées par l'algorithme font matching pour trouver une famille par défaut appropriée si une famille de polices sélectionnée n'est pas disponible.
| Constante | Valeur | Description |
|---|---|---|
QFont::AnyStyle | 5 | laisse l'algorithme de correspondance des polices choisir la famille. Il s'agit de la valeur par défaut. |
QFont::SansSerif | Helvetica | l'algorithme de recherche de polices préfère les polices sans empattement. |
QFont::Helvetica | 0 | est un synonyme de SansSerif. |
QFont::Serif | Times | l'algorithme de recherche de polices préfère les polices avec empattement. |
QFont::Times | 1 | est un synonyme de Serif. |
QFont::TypeWriter | Courier | l'outil de sélection des polices préfère les polices à hauteur fixe. |
QFont::Courier | 2 | est un synonyme de TypeWriter. |
QFont::OldEnglish | 3 | l'outil de sélection des polices de caractères préfère les polices décoratives. |
QFont::Decorative | OldEnglish | est un synonyme de OldEnglish. |
QFont::Monospace | 7 | l'outil de recherche de polices préfère les polices qui correspondent à la famille de polices générique CSS "monospace". |
QFont::Fantasy | 8 | L'outil de recherche de polices préfère les polices qui correspondent à la famille de polices générique CSS "fantasy". |
QFont::Cursive | 6 | l'outil de recherche de polices préfère les polices qui correspondent à la famille de polices générique CSS "cursive". |
QFont::System | 4 | l'outil de recherche de polices préfère les polices système. |
enum QFont::StyleStrategy
La stratégie de style indique à l'algorithme font matching le type de polices à utiliser pour trouver une famille par défaut appropriée.
Les stratégies suivantes sont disponibles :
| Constante | Valeur | Description de la stratégie de style par défaut. |
|---|---|---|
QFont::PreferDefault | 0x0001 | la stratégie de style par défaut. Elle ne privilégie aucun type de police. |
QFont::PreferBitmap | 0x0002 | préfère les polices bitmap (par opposition aux polices de contour). |
QFont::PreferDevice | 0x0004 | préfère les polices de périphériques. |
QFont::PreferOutline | 0x0008 | préfère les polices de contour (par opposition aux polices bitmap). |
QFont::ForceOutline | 0x0010 | impose l'utilisation de polices de contour. |
QFont::NoAntialias | 0x0100 | ne pas antialiaser les polices. |
QFont::NoSubpixelAntialias | 0x0800 | éviter l'anticrénelage sous-pixel sur les polices si possible. |
QFont::PreferAntialias | 0x0080 | antialias si possible. |
QFont::ContextFontMerging (since Qt 6.8) | 0x2000 | Si la police sélectionnée ne contient pas un certain caractère, Qt choisit automatiquement une police de remplacement similaire qui contient le caractère. Par défaut, cela se fait caractère par caractère. Cela signifie que dans certains cas peu courants, plusieurs polices peuvent être utilisées pour représenter une chaîne de texte, même s'il s'agit du même script. En définissant ContextFontMerging, on essaiera de trouver la police de remplacement qui correspond au plus grand sous-ensemble de la chaîne d'entrée à la place. Cela sera plus coûteux pour les chaînes où des glyphes manquent, mais peut donner des résultats plus cohérents. Si NoFontMerging est défini, ContextFontMerging n'aura aucun effet. |
QFont::PreferTypoLineMetrics (since Qt 6.8) | 0x4000 | Pour des raisons de compatibilité, les polices OpenType contiennent deux ensembles concurrents de métriques de lignes verticales qui fournissent les ascent, descent et leading de la police. Ces métriques sont souvent appelées métriques win (Windows) et métriques typo (typographiques). Bien que la spécification recommande l'utilisation de la métrique typo pour l'espacement des lignes, de nombreuses applications préfèrent la métrique win à moins que le drapeau USE_TYPO_METRICS ne soit défini dans le champ fsSelection de la police. Pour des raisons de compatibilité ascendante, c'est également le cas pour les applications Qt. Ce n'est pas un problème pour les polices qui définissent le drapeau USE_TYPO_METRICS pour indiquer que les métriques typo sont valides, ni pour les polices dont les métriques win et typo correspondent. Cependant, pour certaines polices, la métrique win peut être plus grande que l'interligne préférable et l'indicateur USE_TYPO_METRICS peut être désactivé par erreur. Pour ces polices, le réglage de PreferTypoLineMetrics peut donner de meilleurs résultats. |
QFont::NoFontMerging | 0x8000 | Si la police sélectionnée pour un certain système d'écriture ne contient pas un caractère à dessiner, Qt choisit automatiquement une police similaire qui contient le caractère. Le drapeau NoFontMerging désactive cette fonctionnalité. Veuillez noter que l'activation de ce drapeau n'empêchera pas Qt de choisir automatiquement une police appropriée lorsque la police sélectionnée ne prend pas en charge le système d'écriture du texte. |
QFont::PreferNoShaping | 0x1000 | Parfois, une police applique des règles complexes à un ensemble de caractères afin de les afficher correctement. Dans certains systèmes d'écriture, comme les écritures brahmiques, cela est nécessaire pour que le texte soit lisible, mais dans les écritures latines, par exemple, il s'agit simplement d'une caractéristique cosmétique. Le drapeau PreferNoShaping désactivera toutes ces caractéristiques lorsqu'elles ne sont pas nécessaires, ce qui améliorera les performances dans la plupart des cas (depuis Qt 5.10). |
Chacune de ces options peut être combinée par OU avec l'un de ces drapeaux :
| Constante | Valeur | Description |
|---|---|---|
QFont::PreferMatch | 0x0020 | préfère une correspondance exacte. L'outil de recherche de polices essaiera d'utiliser la taille de police exacte qui a été spécifiée. |
QFont::PreferQuality | 0x0040 | préférer la meilleure qualité de police. L'outil de recherche de polices utilisera la taille de point standard la plus proche prise en charge par la police. |
enum QFont::Weight
Qt utilise une échelle de pondération de 1 à 1000 compatible avec OpenType. Un poids de 1 correspond à une police fine, tandis que 1000 correspond à une police extrêmement noire.
Cette énumération contient les poids prédéfinis des polices :
| Constante | Valeur | Description |
|---|---|---|
QFont::Thin | 100 | 100 |
QFont::ExtraLight | 200 | 200 |
QFont::Light | 300 | 300 |
QFont::Normal | 400 | 400 |
QFont::Medium | 500 | 500 |
QFont::DemiBold | 600 | 600 |
QFont::Bold | 700 | 700 |
QFont::ExtraBold | 800 | 800 |
QFont::Black | 900 | 900 |
Documentation sur les fonctions des membres
QFont::QFont()
Construit un objet police qui utilise la police par défaut de l'application.
Voir aussi QGuiApplication::setFont() et QGuiApplication::font().
QFont::QFont(const QFont &font, const QPaintDevice *pd)
Construit une police à partir de font pour l'utiliser sur le périphérique de peinture pd.
QFont::QFont(const QString &family, int pointSize = -1, int weight = -1, bool italic = false)
Construit un objet police avec les paramètres family, pointSize, weight et italic spécifiés.
Si pointSize est égal à zéro ou négatif, la taille des points de la police est fixée à une valeur par défaut dépendant du système. En général, cette valeur est de 12 points.
Le nom family peut éventuellement inclure un nom de fonderie, par exemple "Helvetica [Cronyx]". Si le family est disponible auprès de plusieurs fonderies et que la fonderie n'est pas spécifiée, une fonderie arbitraire est choisie. Si la famille n'est pas disponible, une famille sera définie en utilisant l'algorithme font matching.
Cela divisera la chaîne de la famille sur une virgule et appellera setFamilies() avec la liste résultante. Pour préserver une police qui utilise une virgule dans son nom, utilisez le constructeur qui prend un QStringList.
Voir aussi Weight, setFamily(), setPointSize(), setWeight(), setItalic(), setStyleHint(), setFamilies(), et QGuiApplication::font().
[explicit] QFont::QFont(const QStringList &families, int pointSize = -1, int weight = -1, bool italic = false)
Construit un objet police avec les paramètres families, pointSize, weight et italic spécifiés.
Si pointSize est égal à zéro ou négatif, la taille des points de la police est fixée à une valeur par défaut dépendant du système. En général, cette valeur est de 12 points.
Chaque entrée de nom de famille dans families peut éventuellement inclure un nom de fonderie, par exemple "Helvetica [Cronyx]". Si la famille est disponible dans plus d'une fonderie et que la fonderie n'est pas spécifiée, une fonderie arbitraire est choisie. Si la famille n'est pas disponible, une famille sera définie en utilisant l'algorithme font matching.
Voir aussi Weight, setPointSize(), setWeight(), setItalic(), setStyleHint(), setFamilies(), et QGuiApplication::font().
QFont::QFont(const QFont &font)
Construit une police qui est une copie de font.
[noexcept] QFont::~QFont()
Détruit l'objet police et libère toutes les ressources allouées.
bool QFont::bold() const
Renvoie true si weight() est une valeur supérieure à QFont::Medium; sinon, renvoie false.
Voir aussi weight(), setBold(), et QFontInfo::bold().
QFont::Capitalization QFont::capitalization() const
Renvoie le type de capitalisation actuel de la police.
Voir aussi setCapitalization().
[since 6.7] void QFont::clearFeatures()
Efface toutes les caractéristiques précédemment définies sur le site QFont.
Voir setFeature() pour plus de détails sur les caractéristiques des polices.
Cette fonction a été introduite dans Qt 6.7.
Voir aussi QFont::Tag, setFeature(), unsetFeature(), featureTags(), et featureValue().
[since 6.7] void QFont::clearVariableAxes()
Efface toutes les valeurs d'axes variables précédemment définies sur le site QFont.
Voir setVariableAxis() pour plus de détails sur les axes variables.
Cette fonction a été introduite dans Qt 6.7.
Voir aussi QFont::Tag, setVariableAxis(), unsetVariableAxis(), isVariableAxisSet() et variableAxisValue().
QString QFont::defaultFamily() const
Renvoie le nom de famille correspondant à l'indice de style actuel.
Voir aussi StyleHint, styleHint(), et setStyleHint().
bool QFont::exactMatch() const
Renvoie true si une police du système de fenêtres correspondant exactement aux paramètres de cette police est disponible.
Voir aussi QFontInfo.
QStringList QFont::families() const
Renvoie les noms des familles de polices demandées, c'est-à-dire les noms définis lors du dernier appel à setFamilies() ou via le constructeur. Sinon, il renvoie une liste vide.
Voir aussi setFamily(), setFamilies(), family(), substitutes(), et substitute().
QString QFont::family() const
Renvoie le nom de la famille de polices demandée. Ce nom sera toujours le même que la première entrée de l'appel families().
Voir aussi setFamily(), substitutes(), substitute(), setFamilies() et families().
[since 6.7] QList<QFont::Tag> QFont::featureTags() const
Renvoie une liste de balises pour toutes les caractéristiques de police actuellement définies sur ce site QFont.
Voir setFeature() pour plus de détails sur les caractéristiques des polices.
Cette fonction a été introduite dans Qt 6.7.
Voir aussi QFont::Tag, setFeature(), unsetFeature(), isFeatureSet(), et clearFeatures().
[since 6.7] quint32 QFont::featureValue(QFont::Tag tag) const
Renvoie la valeur définie pour une caractéristique spécifique tag. Si la balise n'a pas été définie, 0 sera renvoyé à la place.
Voir setFeature() pour plus de détails sur les caractéristiques des polices.
Cette fonction a été introduite dans Qt 6.7.
Voir aussi QFont::Tag, setFeature(), unsetFeature(), featureTags(), et isFeatureSet().
bool QFont::fixedPitch() const
Renvoie true si le pas fixe a été défini ; sinon, renvoie false.
Voir aussi setFixedPitch() et QFontInfo::fixedPitch().
bool QFont::fromString(const QString &descrip)
Définit cette police de manière à ce qu'elle corresponde à la description descrip. La description est une liste d'attributs de police séparés par des virgules, telle que renvoyée par toString().
Voir également toString().
QFont::HintingPreference QFont::hintingPreference() const
Renvoie le niveau d'indication actuellement préféré pour les glyphes rendus avec cette police.
Voir aussi setHintingPreference().
[static] void QFont::insertSubstitution(const QString &familyName, const QString &substituteName)
Insère substituteName dans la table de substitution de la famille familyName.
Après avoir substitué une police, déclenchez la mise à jour de la police en détruisant et en recréant tous les objets QFont.
Voir aussi insertSubstitutions(), removeSubstitutions(), substitutions(), substitute() et substitutes().
[static] void QFont::insertSubstitutions(const QString &familyName, const QStringList &substituteNames)
Insère la liste des familles substituteNames dans la liste de substitution de familyName.
Après avoir substitué une police, déclenchez la mise à jour de la police en détruisant et en recréant tous les objets QFont.
Voir aussi insertSubstitution(), removeSubstitutions(), substitutions() et substitute().
bool QFont::isCopyOf(const QFont &f) const
Renvoie true si cette police et f sont des copies l'une de l'autre, c'est-à-dire que l'une d'entre elles a été créée en tant que copie de l'autre et qu'aucune n'a été modifiée depuis. Cette règle est beaucoup plus stricte que celle de l'égalité.
Voir aussi operator=() et operator==().
[since 6.7] bool QFont::isFeatureSet(QFont::Tag tag) const
Retourne vrai si une valeur pour la caractéristique donnée par tag a été définie sur le site QFont, sinon retourne faux.
Voir setFeature() pour plus de détails sur les caractéristiques des polices.
Cette fonction a été introduite dans Qt 6.7.
Voir aussi QFont::Tag, setFeature(), unsetFeature(), featureTags(), et featureValue().
[since 6.7] bool QFont::isVariableAxisSet(QFont::Tag tag) const
Retourne vrai si une valeur pour l'axe variable donné par tag a été définie sur QFont, sinon retourne faux.
Voir setVariableAxis() pour plus de détails sur les axes variables des polices.
Cette fonction a été introduite dans Qt 6.7.
Voir aussi QFont::Tag, setVariableAxis(), unsetVariableAxis(), variableAxisValue(), et clearVariableAxes().
bool QFont::italic() const
Renvoie true si le style() de la police n'est pas le () de la police. QFont::StyleNormal
Voir aussi setItalic() et style().
bool QFont::kerning() const
Renvoie true si le crénage doit être utilisé pour dessiner du texte avec cette police.
Voir également setKerning().
QString QFont::key() const
Renvoie la clé de la police, une représentation textuelle de la police. Elle est généralement utilisée comme clé pour un cache ou un dictionnaire de polices.
Voir aussi QMap.
qreal QFont::letterSpacing() const
Renvoie l'espacement des lettres de la police.
Voir aussi setLetterSpacing(), letterSpacingType(), et setWordSpacing().
QFont::SpacingType QFont::letterSpacingType() const
Renvoie le type d'espacement utilisé pour l'espacement des lettres.
Voir aussi letterSpacing(), setLetterSpacing() et setWordSpacing().
bool QFont::overline() const
Renvoie true si le surlignage a été défini ; sinon, renvoie false.
Voir aussi setOverline().
int QFont::pixelSize() const
Renvoie la taille en pixels de la police si elle a été définie avec setPixelSize(). Retourne -1 si la taille a été définie avec setPointSize() ou setPointSizeF().
Voir aussi setPixelSize(), pointSize(), QFontInfo::pointSize() et QFontInfo::pixelSize().
int QFont::pointSize() const
Renvoie la taille en points de la police. Retourne -1 si la taille de la police a été spécifiée en pixels.
Voir aussi setPointSize() et pointSizeF().
qreal QFont::pointSizeF() const
Renvoie la taille en points de la police. Retourne -1 si la taille de la police a été spécifiée en pixels.
Voir aussi pointSize(), setPointSizeF(), pixelSize(), QFontInfo::pointSize() et QFontInfo::pixelSize().
[static] void QFont::removeSubstitutions(const QString &familyName)
Supprime toutes les substitutions pour familyName.
Voir aussi insertSubstitutions(), insertSubstitution(), substitutions(), et substitute().
QFont QFont::resolve(const QFont &other) const
Renvoie une nouvelle police QFont dont les attributs ont été copiés à partir de other et qui n'ont pas été définis auparavant sur cette police.
void QFont::setBold(bool enable)
Si enable est vrai, il fixe le poids de la police à QFont::Bold; sinon, il fixe le poids à QFont::Normal.
Pour un contrôle plus fin de la graisse, utilisez setWeight().
Remarque : si styleName() est défini, cette valeur peut être ignorée ou, si elle est prise en charge par la plate-forme, la police peut être artificiellement mise en gras.
Voir également bold() et setWeight().
void QFont::setCapitalization(QFont::Capitalization caps)
Définit la capitalisation du texte dans cette police à caps.
La capitalisation d'une police fait apparaître le texte dans le mode de capitalisation sélectionné.
Voir aussi capitalization().
void QFont::setFamilies(const QStringList &families)
Définit la liste des noms de famille pour la police. Les noms sont insensibles à la casse et peuvent inclure un nom de fonderie. La première famille de families sera définie comme la famille principale de la police.
Chaque entrée de nom de famille dans families peut optionnellement inclure un nom de fonderie, par exemple "Helvetica [Cronyx]". Si la famille est disponible dans plus d'une fonderie et que la fonderie n'est pas spécifiée, une fonderie arbitraire est choisie. Si la famille n'est pas disponible, une famille sera définie en utilisant l'algorithme font matching.
Voir aussi family(), families(), setFamily(), setStyleHint(), et QFontInfo.
void QFont::setFamily(const QString &family)
Définit le nom de famille de la police. Le nom est insensible à la casse et peut inclure un nom de fonderie.
Le nom family peut optionnellement inclure un nom de fonderie, par exemple "Helvetica [Cronyx]". Si la famille family est disponible dans plus d'une fonderie et que la fonderie n'est pas spécifiée, une fonderie arbitraire est choisie. Si la famille n'est pas disponible, une famille sera définie en utilisant l'algorithme font matching.
Voir aussi family(), setStyleHint(), setFamilies(), families(), et QFontInfo.
[since 6.7] void QFont::setFeature(QFont::Tag tag, quint32 value)
Applique une valeur entière à la caractéristique typographique spécifiée par tag lors de la mise en forme du texte. Cela permet un accès avancé au processus de mise en forme des polices et peut être utilisé pour prendre en charge des caractéristiques de police qui ne sont pas couvertes par l'API.
La caractéristique est spécifiée par un tag, qui est généralement encodé à partir du nom de la caractéristique à quatre caractères dans la carte des caractéristiques de la police.
Cet entier value transmis avec la balise représente dans la plupart des cas une valeur booléenne : Une valeur nulle signifie que la fonctionnalité est désactivée, et une valeur non nulle signifie qu'elle est activée. Pour certaines caractéristiques de police, cependant, il peut avoir d'autres interprétations. Par exemple, lorsqu'elle est appliquée à la fonction salt, la valeur est un index qui spécifie l'alternative stylistique à utiliser.
Par exemple, la fonction de police frac convertira les fractions diagonales séparées par une barre oblique (comme 1/2) en une représentation différente. Typiquement, cela implique de faire passer la fraction complète dans une largeur de caractère unique (comme ½).
Si une police prend en charge la fonctionnalité frac, elle peut être activée dans la mise en forme en définissant features["frac"] = 1 dans la carte des caractéristiques de la police.
Remarque : par défaut, Qt active et désactive certaines caractéristiques des polices en fonction d'autres propriétés des polices. En particulier, la fonction kern sera activée/désactivée en fonction de la propriété kerning() de la police QFont. En outre, toutes les fonctions de ligature (liga, clig, dlig, hlig) seront désactivées si une propriété letterSpacing() est appliquée, mais uniquement pour les systèmes d'écriture dans lesquels l'utilisation de la ligature est cosmétique. Pour les systèmes d'écriture où les ligatures sont nécessaires, les caractéristiques resteront dans leur état par défaut. Les valeurs définies à l'aide de setFeature() et des fonctions connexes remplaceront le comportement par défaut. Si, par exemple, la caractéristique "kern" est définie à 1, le crénage sera toujours activé, même si la propriété "kerning" est définie à false. De même, si elle est définie sur 0, elle sera toujours désactivée. Pour rétablir le comportement par défaut d'une fonction de police, vous pouvez la désactiver à l'aide de unsetFeature().
Cette fonction a été introduite dans Qt 6.7.
Voir aussi QFont::Tag, clearFeatures(), unsetFeature(), et featureTags().
void QFont::setFixedPitch(bool enable)
Si enable est vrai, le pas fixe est activé ; sinon, le pas fixe est désactivé.
Voir aussi fixedPitch() et QFontInfo.
void QFont::setHintingPreference(QFont::HintingPreference hintingPreference)
Définir la préférence pour le niveau d'indication des glyphes à hintingPreference. Il s'agit d'une indication au système de rendu des polices sous-jacentes d'utiliser un certain niveau d'indication, et la prise en charge varie d'une plate-forme à l'autre. Voir le tableau dans la documentation pour QFont::HintingPreference pour plus de détails.
La préférence d'indication par défaut est QFont::PreferDefaultHinting.
Voir également hintingPreference().
void QFont::setItalic(bool enable)
Définit le style style() de la police à QFont::StyleItalic si enable est vrai ; sinon, le style est défini à QFont::StyleNormal.
Remarque : si styleName() est défini, cette valeur peut être ignorée ou, si elle est prise en charge par la plate-forme, la police peut être rendue inclinée au lieu de choisir une variante de police italique.
Voir également italic() et QFontInfo.
void QFont::setKerning(bool enable)
Active le crénage pour cette police si enable est vrai, sinon le désactive. Par défaut, le crénage est activé.
Lorsque le crénage est activé, les métriques des glyphes ne s'additionnent plus, même pour les textes latins. En d'autres termes, l'hypothèse selon laquelle width('a') + width('b') est égal à width("ab") n'est pas nécessairement vraie.
Voir aussi kerning() et QFontMetrics.
void QFont::setLetterSpacing(QFont::SpacingType type, qreal spacing)
Définit l'espacement des lettres de la police sur spacing et le type d'espacement sur type.
L'espacement des lettres modifie l'espacement par défaut entre les lettres individuelles de la police. L'espacement entre les lettres peut être réduit ou augmenté, soit en pourcentage de la largeur du caractère, soit en pixels, en fonction du type d'espacement sélectionné.
Voir également letterSpacing(), letterSpacingType() et setWordSpacing().
void QFont::setOverline(bool enable)
Si enable est vrai, le surlignage est activé ; sinon, le surlignage est désactivé.
Voir aussi overline() et QFontInfo.
void QFont::setPixelSize(int pixelSize)
Définit la taille de la police à pixelSize pixels, avec une taille maximale d'un entier non signé de 16 bits.
L'utilisation de cette fonction rend la police dépendante du périphérique. Utilisez setPointSize() ou setPointSizeF() pour définir la taille de la police indépendamment du périphérique.
Voir aussi pixelSize().
void QFont::setPointSize(int pointSize)
Définit la taille du point à pointSize. La taille du point doit être supérieure à zéro.
Voir aussi pointSize() et setPointSizeF().
void QFont::setPointSizeF(qreal pointSize)
Fixe la taille du point à pointSize. La taille du point doit être supérieure à zéro. La précision demandée peut ne pas être atteinte sur toutes les plateformes.
Voir aussi pointSizeF(), setPointSize() et setPixelSize().
void QFont::setStretch(int factor)
Définit le facteur d'étirement de la police.
Le facteur d'étirement correspond à une version condensée ou étendue de la police ou applique une transformation d'étirement qui modifie la largeur de tous les caractères de la police de factor pour cent. Par exemple, si vous définissez factor sur 150, tous les caractères de la police seront 1,5 fois plus larges (c'est-à-dire 150 %). Le facteur d'étirement minimum est de 1 et le facteur d'étirement maximum est de 4000. Le facteur d'étirement par défaut est AnyStretch, qui accepte n'importe quel facteur d'étirement et n'applique aucune transformation à la police.
Le facteur d'étirement n'est appliqué qu'aux polices de contour. Le facteur d'étirement est ignoré pour les polices bitmap.
Remarque : lorsqu'une police est associée à un facteur d'étirement natif autre que celui par défaut, le fait de demander un facteur d'étirement de 100 la ramènera à une police de largeur moyenne.
Voir également stretch() et QFont::Stretch.
void QFont::setStrikeOut(bool enable)
Si enable est vrai, il active la suppression des caractères ; sinon, il la désactive.
Voir aussi strikeOut() et QFontInfo.
void QFont::setStyle(QFont::Style style)
Définit le style de la police à style.
Voir aussi style(), italic() et QFontInfo.
void QFont::setStyleHint(QFont::StyleHint hint, QFont::StyleStrategy strategy = PreferDefault)
Définit l'indice et la stratégie de style à hint et strategy, respectivement.
Si ces valeurs ne sont pas définies explicitement, l'indice de style prendra par défaut la valeur AnyStyle et la stratégie de style la valeur PreferDefault.
Qt ne prend pas en charge les indications de style sur X11 car cette information n'est pas fournie par le système de fenêtres.
Voir aussi StyleHint, styleHint(), StyleStrategy, styleStrategy(), et QFontInfo.
void QFont::setStyleName(const QString &styleName)
Définit le nom de style de la police à styleName. Lorsqu'il est défini, d'autres propriétés de style telles que style() et weight() seront ignorées pour la correspondance des polices, bien qu'elles puissent être simulées par la suite si elles sont prises en charge par le moteur de polices de la plate-forme.
En raison de la qualité inférieure des styles artificiellement simulés et de l'absence de prise en charge complète par plusieurs plateformes, il n'est pas recommandé d'utiliser la correspondance par nom de style en même temps que la correspondance par propriétés de style
Voir aussi styleName().
void QFont::setStyleStrategy(QFont::StyleStrategy s)
Définit la stratégie de style pour la police à s.
Voir aussi styleStrategy() et QFont::StyleStrategy.
void QFont::setUnderline(bool enable)
Si enable est vrai, le soulignement est activé ; sinon, le soulignement est désactivé.
Voir aussi underline() et QFontInfo.
[since 6.7] void QFont::setVariableAxis(QFont::Tag tag, float value)
Applique une police value à l'axe variable correspondant à tag.
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 instances spécifiques sont généralement nommées par le concepteur de la police et, dans Qt Designer, elles peuvent être sélectionnées à l'aide de setStyleName(), tout comme les sous-familles traditionnelles.
Dans certains cas, il est également utile de fournir des valeurs arbitraires pour les différents axes. Par exemple, si une police possède une sous-famille Regular et une sous-famille Bold, vous pouvez souhaiter un poids intermédiaire entre ces deux sous-familles. Vous pouvez alors le demander manuellement en fournissant une valeur personnalisée pour l'axe "wght" de la police.
Si l'axe "wght" est pris en charge par la police et que la valeur fournie se situe dans la plage définie, une police correspondant au poids 550.0 sera fournie.
Il existe quelques axes standard que de nombreuses polices fournissent, tels que "wght" (poids), "wdth" (largeur), "ital" (italique) et "opsz" (taille optique). Chacune d'entre elles a des plages individuelles définies dans la police elle-même. Par exemple, "wght" peut s'étendre de 100 à 900 (QFont::Thin à QFont::Black) tandis que "ital" peut s'étendre de 0 à 1 (de non italique à totalement italique).
Une police peut également choisir de définir des axes personnalisés ; la seule limitation est que le nom doit répondre aux exigences d'un QFont::Tag (séquence de quatre caractères latins-1).
Par défaut, aucun axe variable n'est défini.
Remarque : sous Windows, les axes variables ne sont pas pris en charge si la police GDI optionnelle est utilisée.
Cette fonction a été introduite dans Qt 6.7.
Voir aussi unsetVariableAxis.
void QFont::setWeight(QFont::Weight weight)
Définit le poids de la police à weight, en utilisant l'échelle définie par l'énumération QFont::Weight.
Remarque : si styleName() est défini, cette valeur peut être ignorée pour la sélection des polices.
Voir également weight() et QFontInfo.
void QFont::setWordSpacing(qreal spacing)
Définit l'espacement des mots pour la police à spacing.
L'espacement entre les mots modifie l'espacement par défaut entre les mots individuels. Une valeur positive augmente l'espacement entre les mots d'un nombre correspondant de pixels, tandis qu'une valeur négative diminue l'espacement entre les mots en conséquence.
L'espacement entre les mots ne s'applique pas aux systèmes d'écriture, dans lesquels les mots individuels ne sont pas séparés par un espace blanc.
Voir également wordSpacing() et setLetterSpacing().
int QFont::stretch() const
Renvoie le facteur d'étirement de la police.
Voir aussi setStretch().
bool QFont::strikeOut() const
Renvoie true si le mot "strikeout" a été défini ; sinon, renvoie false.
Voir aussi setStrikeOut().
QFont::Style QFont::style() const
Renvoie le style de la police.
Voir aussi setStyle().
QFont::StyleHint QFont::styleHint() const
Renvoie l'adresse StyleHint.
L'indice de style affecte le font matching algorithm. Voir QFont::StyleHint pour la liste des indices disponibles.
Voir aussi setStyleHint(), QFont::StyleStrategy, et QFontInfo::styleHint().
QString QFont::styleName() const
Renvoie le nom du style de police demandé. Ceci peut être utilisé pour faire correspondre la police avec des styles irréguliers (qui ne peuvent pas être normalisés dans d'autres propriétés de style).
Voir aussi setStyleName(), setFamily() et setStyle().
QFont::StyleStrategy QFont::styleStrategy() const
Renvoie l'algorithme StyleStrategy.
La stratégie de style affecte l'algorithme font matching. Voir QFont::StyleStrategy pour la liste des stratégies disponibles.
Voir aussi setStyleStrategy(), setStyleHint(), et QFont::StyleHint.
[static] QString QFont::substitute(const QString &familyName)
Renvoie le premier nom de famille à utiliser lorsque familyName est spécifié. La recherche est insensible à la casse.
S'il n'y a pas de substitution pour familyName, familyName est renvoyé.
Pour obtenir une liste des substitutions, utilisez substitutes().
Voir aussi setFamily(), insertSubstitutions(), insertSubstitution() et removeSubstitutions().
[static] QStringList QFont::substitutes(const QString &familyName)
Renvoie une liste de noms de famille à utiliser lorsque familyName est spécifié. La recherche est insensible à la casse.
S'il n'y a pas de substitution pour familyName, une liste vide est renvoyée.
Voir aussi substitute(), insertSubstitutions(), insertSubstitution() et removeSubstitutions().
[static] QStringList QFont::substitutions()
Renvoie une liste triée des noms de famille substitués.
Voir aussi insertSubstitution(), removeSubstitutions(), et substitute().
[noexcept] void QFont::swap(QFont &other)
Remplace cette instance de police par other. Cette opération est très rapide et n'échoue jamais.
QString QFont::toString() const
Renvoie une description de la police. La description est une liste d'attributs séparés par des virgules, parfaitement adaptée à une utilisation dans QSettings, et se compose des éléments suivants :
- Famille de police
- Taille du point
- Taille du pixel
- Indice de style
- Poids de la police
- Style de police
- Souligné
- Barré
- Hauteur fixe
- Toujours 0
- Majuscules
- Espacement des lettres
- Espacement des mots
- Étirement
- Stratégie de style
- Style de police
- Caractéristiques de la police
- Axes variables
Voir aussi fromString().
bool QFont::underline() const
Renvoie true si le soulignement a été défini ; sinon, renvoie false.
Voir aussi setUnderline().
[since 6.7] void QFont::unsetFeature(QFont::Tag tag)
Désactive le site tag de la carte des caractéristiques explicitement activées/désactivées.
Remarque : même si la caractéristique n'a pas été ajoutée précédemment, cette opération marquera la carte des caractéristiques de la police comme étant modifiée sur ce site QFont, de sorte qu'elle aura la priorité lors de la comparaison avec d'autres polices.
La désactivation d'une caractéristique existante sur le site QFont rétablit le comportement par défaut.
Voir setFeature() pour plus de détails sur les caractéristiques des polices.
Cette fonction a été introduite dans Qt 6.7.
Voir aussi QFont::Tag, clearFeatures(), setFeature(), featureTags(), et featureValue().
[since 6.7] void QFont::unsetVariableAxis(QFont::Tag tag)
Annule une valeur d'axe variable précédemment définie par tag.
Remarque : si aucune valeur n'a été donnée précédemment pour cette balise, le site QFont considérera toujours ses axes variables comme définis lors de la comparaison avec d'autres valeurs du site QFont.
Cette fonction a été introduite dans Qt 6.7.
Voir aussi setVariableAxis.
[since 6.7] QList<QFont::Tag> QFont::variableAxisTags() const
Renvoie une liste de balises pour tous les axes variables actuellement définis sur ce site QFont.
Voir setVariableAxis() pour plus de détails sur les axes variables.
Cette fonction a été introduite dans Qt 6.7.
Voir aussi QFont::Tag, setVariableAxis(), unsetVariableAxis(), isVariableAxisSet(), et clearVariableAxes().
[since 6.7] float QFont::variableAxisValue(QFont::Tag tag) const
Renvoie la valeur définie pour un axe variable spécifique tag. Si la balise n'a pas été définie, 0.0 sera renvoyé à la place.
Voir setVariableAxis() pour plus de détails sur les axes variables.
Cette fonction a été introduite dans Qt 6.7.
Voir aussi QFont::Tag, setVariableAxis(), unsetVariableAxis(), isVariableAxisSet(), et clearVariableAxes().
QFont::Weight QFont::weight() const
Renvoie le poids de la police, en utilisant la même échelle que l'énumération QFont::Weight.
Voir aussi setWeight(), Weight, et QFontInfo.
qreal QFont::wordSpacing() const
Renvoie l'espacement des mots de la police.
Voir aussi setWordSpacing() et setLetterSpacing().
QFont::operator QVariant() const
Retourne la police sous forme de QVariant
bool QFont::operator!=(const QFont &f) const
Renvoie true si cette police est différente de f; sinon, renvoie false.
Deux QFonts sont considérées comme différentes si leurs attributs de police sont différents.
Voir également operator==().
bool QFont::operator<(const QFont &f) const
Fournit une comparaison arbitraire entre cette police et la police f. Tout ce qui est garanti est que l'opérateur renvoie false si les deux polices sont égales et que (f1 < f2) == !(f2 < f1) si les polices ne sont pas égales.
Cette fonction est utile dans certaines circonstances, par exemple si vous souhaitez utiliser des objets QFont comme clés dans une base de données QMap.
Voir aussi operator==(), operator!=() et isCopyOf().
[noexcept] QFont &QFont::operator=(QFont &&other)
Move-assigne other à cette instance QFont.
QFont &QFont::operator=(const QFont &font)
Attribue font à cette police et renvoie une référence à celle-ci.
bool QFont::operator==(const QFont &f) const
Renvoie true si cette police est égale à f; sinon renvoie false.
Deux QFonts sont considérées comme égales si leurs attributs de police sont identiques.
Voir aussi operator!=() et isCopyOf().
Non-membres apparentés
[noexcept] size_t qHash(const QFont &key, size_t seed = 0)
Renvoie la valeur de hachage pour key, en utilisant seed comme base de calcul.
QDataStream &operator<<(QDataStream &s, const QFont &font)
Écrit la police font dans le flux de données s(toString() écrit dans un flux de texte).
Voir aussi Format des opérateurs QDataStream.
QDataStream &operator>>(QDataStream &s, QFont &font)
Lit la police font dans le flux de données s(fromString() lit un flux de texte).
Voir aussi Format des opérateurs QDataStream.
© 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.