QFont Class
La classe QFont définit une requête concernant une police utilisée pour l'affichage du texte. En savoir plus...
| 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 obsolètes
- QFont fait partie des classes de dessin, des classes implicitement partagées et des API de traitement de texte enrichi.
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(QFont &&) | |
| ~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 associé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 portant sur une ou plusieurs polices présentes sur le système.
Lorsque vous créez un objet QFont, vous spécifiez les différents attributs que vous souhaitez attribuer à la police. Qt utilisera la police présentant les attributs spécifiés ; s’il n’existe aucune police correspondant à ces critères, Qt utilisera la police installée la plus proche. Les attributs de la police effectivement utilisée peuvent être récupérés à partir d’un objet ` QFontInfo `. Si le système de fenêtrage fournit une correspondance exacte, la fonction ` exactMatch()` renvoie ` true`. Utilisez ` QFontMetricsF ` pour obtenir des mesures, par exemple la longueur en pixels d’une chaîne à l’aide de la fonction ` QFontMetrics::horizontalAdvance()`.
Les attributs qui ne sont pas spécifiquement définis n’influenceront pas l’algorithme de sélection des polices, et les valeurs par défaut seront privilégiées à leur place.
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 de pouvoir utiliser un `QFont`. Vous pouvez définir la police par défaut de l’application à l’aide de la fonction ` QGuiApplication::setFont()`.
Si la police choisie ne contient pas tous les caractères à afficher, QFont tentera de trouver ces caractères dans les polices équivalentes les plus proches. Lorsqu’un objet ` QPainter ` extrait un caractère d’une police, QFont indique s’il dispose ou non de ce caractère ; dans le cas contraire, ` QPainter ` affichera un carré vide.
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 une fois 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 différer. Les valeurs réelles sont disponibles via un objet ` QFontInfo `.
Si la famille de polices demandée n’est pas disponible, vous pouvez influencer l’ font matching algorithm e en choisissant une « QFont::StyleHint » et une « QFont::StyleStrategy » spécifiques à l’aide de la fonction setStyleHint(). La famille par défaut (correspondant à l’indication de style actuelle) est renvoyée par la fonction defaultFamily().
Vous pouvez fournir des substitutions pour les noms de familles de polices à l’aide de insertSubstitution() et insertSubstitutions(). Les substitutions peuvent être supprimées avec removeSubstitutions(). Utilisez substitute() pour récupérer la première substitution d’une famille, ou le nom de la famille lui-même si elle ne comporte aucune substitution. Utilisez substitutes() pour récupérer une liste des substitutions d’une famille (qui peut être vide). Après avoir remplacé une police, vous devez déclencher la mise à jour de celle-ci en détruisant puis en recréant tous les objets `QFont`.
Chaque QFont dispose d’une méthode ` key()` que vous pouvez utiliser, par exemple, comme clé dans un cache ou un dictionnaire. Si vous souhaitez enregistrer les préférences d’un utilisateur en matière de polices, vous pouvez utiliser ` QSettings`, en écrivant les informations relatives à la police avec ` toString()` et en les relisant avec ` fromString()`. Les opérateurs `<<()` et `>>()` sont également disponibles, mais ils fonctionnent sur un flux de données.
Il est possible de définir la hauteur des caractères affichés à l’écran sur un nombre de pixels spécifié à l’aide de ` setPixelSize()` ; toutefois, l’utilisation de ` setPointSize()` produit un effet similaire et garantit l’indépendance vis-à-vis du périphérique.
Le chargement des polices peut être coûteux, en particulier sous X11. QFont intègre de nombreuses optimisations pour accélérer la copie des objets QFont et pour mettre en cache les résultats des fonctions lentes du système de fenêtrage dont il dépend.
L’algorithme de correspondance des polices fonctionne comme suit :
- Le système recherche les familles de polices spécifiées (définies par la fonction ` setFamilies()`).
- Si elles n'existent pas, une police de remplacement prenant en charge le système d'écriture est sélectionnée. L'algorithme de correspondance des polices tentera de trouver la meilleure correspondance pour toutes les propriétés définies dans l'objet QFont. La manière dont cela est effectué varie d'une plate-forme à l'autre.
- Si aucune police capable de prendre en charge le texte n'existe sur le système, des cases spéciales « caractères manquants » s'afficheront à la place.
Remarque : si la police sélectionnée, bien qu’elle prenne en charge le système d’écriture en général, ne dispose pas des glyphes pour un ou plusieurs caractères spécifiques, Qt tentera alors de trouver une police de secours 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 pour la police « Courier » est automatiquement remplacée par « Courier New », une version améliorée de Courier qui permet une mise à l'échelle fluide. 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 attributs restants sont mis en correspondance par ordre de priorité :
- fixedPitch()
- pointSize() (voir ci-dessous)
- weight()
- style()
Si vous disposez d’une police dont la famille correspond, même si aucun des autres attributs ne correspond, cette police sera privilégiée par rapport à une police dont la famille ne correspond pas mais dont les autres attributs correspondent. En effet, la famille de police est le critère de recherche principal.
La taille en points est considérée comme correspondante si elle s'écarte de moins de 20 % de la taille demandée. Lorsque plusieurs polices correspondent et ne se distinguent que par leur taille en points, la police dont la taille est la plus proche de celle demandée sera choisie.
La famille, la taille, l’épaisseur et les autres attributs de police effectivement utilisés pour l’affichage du texte dépendront de ce qui est disponible pour la famille choisie dans le système de fenêtrage. Un objet « QFontInfo » peut être utilisé pour déterminer les valeurs réelles utilisées pour l’affichage du texte.
Exemples :
QFont f("Helvetica");Si vous disposez à la fois d’une police Helvetica d’Adobe et d’une police Helvetica de Cronyx, l’une ou l’autre pourrait être utilisée.
QFont f("Helvetica [Cronyx]");Vous pouvez préciser la fonderie de votre choix dans le nom de la famille. La police f dans l’exemple ci-dessus s’affichera alors sous la forme « Helvetica [Cronyx] ».
Pour déterminer les attributs de la police effectivement utilisée par le système de fenêtrage, utilisez un objet ` QFontInfo `, par exemple :
Pour connaître les métriques de la police, 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 plus d'informations générales sur les polices, consultez la FAQ de la liste comp.fonts. Vous trouverez des informations sur les encodages sur la page UTR17.
Voir également QFontMetrics, QFontInfo et QFontDatabase.
Documentation sur les types de membres
enum QFont::Capitalization
Option d'affichage pour le texte auquel cette police s'applique.
| Constante | Valeur | Description |
|---|---|---|
QFont::MixedCase | 0 | Il s’agit de l’option de rendu de texte standard, qui n’applique aucun changement de casse. |
QFont::AllUppercase | 1 | Cette option modifie le texte pour qu’il soit affiché entièrement en majuscules. |
QFont::AllLowercase | 2 | Cette option modifie le texte pour qu’il s’affiche entièrement en minuscules. |
QFont::SmallCaps | 3 | Cette option modifie le texte pour qu'il s'affiche en petites capitales. |
QFont::Capitalize | 4 | Cette option modifie l'affichage du texte en mettant la première lettre de chaque mot en majuscule. |
enum QFont::HintingPreference
Cette énumération décrit les différents niveaux d'hinting pouvant être appliqués aux glyphes afin d'améliorer la lisibilité sur les écrans où la densité de pixels pourrait le justifier.
| Constante | Valeur | Description |
|---|---|---|
QFont::PreferDefaultHinting | 0 | Utiliser le niveau de hinting par défaut de la plateforme cible. |
QFont::PreferNoHinting | 1 | Si possible, affichez le texte sans appliquer de hinting aux contours des glyphes. La mise en page du texte sera typographiquement précise et redimensionnable, en utilisant les mêmes métriques que celles utilisées, par exemple, lors de l'impression. |
QFont::PreferVerticalHinting | 2 | Si possible, afficher le texte sans lissage horizontal, mais en alignant 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 les métriques horizontales des glyphes ne sont pas lissées, la mise en page du texte sera adaptable aux périphériques à plus haute densité (tels que les imprimantes) sans affecter les détails tels que les sauts de ligne. |
QFont::PreferFullHinting | 3 | Si possible, affichez le texte avec un hinting à la fois horizontal et vertical. Le texte sera modifié pour optimiser la lisibilité sur l’appareil cible, mais comme les métriques dépendront de la taille cible du texte, les positions des glyphes, les sauts de ligne et autres détails typographiques ne s’adapteront pas à l’échelle, ce qui signifie que la mise en page d’un texte peut présenter un rendu différent sur des appareils 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 de hinting n’est pas prise en charge sur toutes les plateformes supportées par Qt. Le tableau suivant détaille l’effet d’une préférence de hinting donnée sur un ensemble sélectionné de plateformes cibles.
| PreferDefaultHinting | PreferNoHinting | PreferVerticalHinting | PreferFullHinting | |
|---|---|---|---|---|
| Windows et DirectWrite activés dans Qt | Hinting complet | Hinting vertical | Hinting vertical | Hinting complet |
| FreeType | Paramètres du système d'exploitation | Pas d'optimisation | Hinting vertical (léger) | Hinting complet |
| Cocoa sous macOS | Pas de lissage | Pas d'hinting | Pas d'optimisation | Pas de hinting |
enum QFont::SpacingType
| Constante | Valeur | Description |
|---|---|---|
QFont::PercentageSpacing | 0 | Une valeur de 100 conserve l'espacement inchangé ; une valeur de 200 augmente 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 entre les lettres du nombre de pixels correspondant ; une valeur négative le réduit. |
enum QFont::Stretch
Valeurs d'étirement prédéfinies respectant la convention de nommage 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 d'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 également setStretch() et stretch().
enum QFont::Style
Cette énumération décrit les différents styles de glyphes utilisés pour afficher du texte.
| Constante | Valeur | Description |
|---|---|---|
QFont::StyleNormal | 0 | Glyphes normaux utilisés dans le texte sans mise en forme. |
QFont::StyleItalic | 1 | Glyphes italiques spécialement conçus pour représenter du texte en italique. |
QFont::StyleOblique | 2 | Glyphes d'aspect italique qui sont généralement basés sur les glyphes sans style, mais qui ne sont pas optimisés pour représenter du texte en italique. |
Voir également 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 la famille de polices sélectionnée n’est pas disponible.
| Constante | Valeur | Description |
|---|---|---|
QFont::AnyStyle | 5 | laisse à l’algorithme de correspondance des polices le soin de choisir la famille. Il s’agit de la valeur par défaut. |
QFont::SansSerif | Helvetica | L'algorithme de correspondance des polices privilégie les polices sans empattement. |
QFont::Helvetica | 0 | est un synonyme de « SansSerif ». |
QFont::Serif | Times | L'algorithme de correspondance des polices privilégie les polices avec empattement. |
QFont::Times | 1 | est un synonyme de « Serif ». |
QFont::TypeWriter | Courier | L'algorithme de correspondance des polices privilégie les polices à espacement fixe. |
QFont::Courier | 2 | synonyme de « TypeWriter ». |
QFont::OldEnglish | 3 | Le module de correspondance des polices privilégie les polices décoratives. |
QFont::Decorative | OldEnglish | est un synonyme de « OldEnglish ». |
QFont::Monospace | 7 | Le module de correspondance des polices privilégie les polices correspondant à la famille de polices générique CSS « monospace ». |
QFont::Fantasy | 8 | Le module de correspondance des polices privilégie les polices correspondant à la famille de polices générique CSS « fantasy ». |
QFont::Cursive | 6 | Le module de correspondance des polices privilégie les polices correspondant à la famille de polices générique CSS « cursive ». |
QFont::System | 4 | Le système de correspondance des polices privilégie les polices système. |
enum QFont::StyleStrategy
La stratégie de style indique à l'algorithme « font matching » quel type de polices doit être utilisé pour trouver une famille par défaut appropriée.
Les stratégies suivantes sont disponibles :
| Constante | Valeur | Description |
|---|---|---|
QFont::PreferDefault | 0x0001 | stratégie de style par défaut. Elle ne privilégie aucun type de police en particulier. |
QFont::PreferBitmap | 0x0002 | Privilégie les polices bitmap (par opposition aux polices vectorielles). |
QFont::PreferDevice | 0x0004 | Privilégie les polices de périphérique. |
QFont::PreferOutline | 0x0008 | Privilégie les polices vectorielles (par opposition aux polices bitmap). |
QFont::ForceOutline | 0x0010 | impose l'utilisation de polices vectorielles. |
QFont::NoAntialias | 0x0100 | N'applique pas d'anticrénelage aux polices. |
QFont::NoSubpixelAntialias | 0x0800 | Évite l'anticrénelage au niveau des sous-pixels sur les polices si possible. |
QFont::PreferAntialias | 0x0080 | Applique l'anticrénelage si possible. |
QFont::ContextFontMerging (since Qt 6.8) | 0x2000 | Si la police sélectionnée ne contient pas un caractère donné, Qt choisit automatiquement une police de secours d'aspect similaire qui contient ce caractère. Par défaut, cette opération s'effectue caractère par caractère. Cela signifie que, dans certains cas rares, plusieurs polices peuvent être utilisées pour représenter une même chaîne de texte, même si celle-ci appartient à la même écriture. En définissant ` ContextFontMerging `, le système tentera plutôt de trouver la police de secours qui correspond au plus grand sous-ensemble de la chaîne de caractères d’entrée. Cette opération sera plus gourmande en ressources pour les chaînes comportant des glyphes manquants, mais pourra donner des résultats plus cohérents. Si ` NoFontMerging ` est défini, alors ` 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 valeurs « ascent », « descent » et « leading » de la police. Celles-ci sont souvent appelées métriques « win » (Windows) et métriques « typo » (typographiques). Bien que la spécification recommande d’utiliser les métriques « typo » pour l’espacement des lignes, de nombreuses applications préfèrent les métriques « win », sauf si l’indicateur « USE_TYPO_METRICS » est activé dans le champ fsSelection de la police. Pour des raisons de compatibilité ascendante, c’est également le cas pour les applications Qt. Cela ne pose pas de problème pour les polices qui définissent l’indicateur « USE_TYPO_METRICS » pour indiquer que les métriques « typo » sont valides, ni pour celles où les métriques « win » et « typo » coïncident. Cependant, pour certaines polices, les métriques « win » peuvent être supérieures à l’espacement de ligne souhaité et l’indicateur « USE_TYPO_METRICS » peut être désactivé par erreur. Pour ces polices, l’utilisation de « PreferTypoLineMetrics » peut donner de meilleurs résultats. |
QFont::NoFontMerging | 0x8000 | Si la police sélectionnée pour un système d’écriture donné ne contient pas un caractère à afficher, Qt choisit automatiquement une police d’aspect similaire qui contient ce caractère. L’indicateur NoFontMerging désactive cette fonctionnalité. Veuillez noter que l’activation de cet indicateur n’empêchera pas Qt de choisir automatiquement une police adapté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, tels que les scripts brahmiques, cela est nécessaire pour que le texte soit lisible, mais dans le script latin, par exemple, il s’agit simplement d’une fonctionnalité esthétique. L'indicateur « PreferNoShaping » désactivera toutes ces fonctionnalités lorsqu'elles ne sont pas nécessaires, ce qui améliorera les performances dans la plupart des cas (depuis Qt 5.10). |
Chacun de ces indicateurs peut être combiné à l’aide d’un « OU » avec l’un des indicateurs suivants :
| Constante | Valeur | Description |
|---|---|---|
QFont::PreferMatch | 0x0020 | privilégie une correspondance exacte. Le module de correspondance des polices tentera d’utiliser la taille de police exacte qui a été spécifiée. |
QFont::PreferQuality | 0x0040 | Privilégie la police offrant la meilleure qualité. Le module de correspondance des polices utilisera la taille en points standard la plus proche prise en charge par la police. |
enum QFont::Weight
Qt utilise une échelle de graisse allant de 1 à 1 000, compatible avec OpenType. Une graisse de 1 correspond à une police fine, tandis qu'une graisse de 1 000 correspond à une police extrêmement épaisse.
Cette énumération contient les graisses de police prédéfinies :
| 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 membres
QFont::QFont()
Crée un objet police qui utilise la police par défaut de l'application.
Voir également QGuiApplication::setFont() et QGuiApplication::font().
QFont::QFont(const QFont &font, const QPaintDevice *pd)
Crée une police à partir de font pour une utilisation sur le périphérique de dessin pd.
QFont::QFont(const QString &family, int pointSize = -1, int weight = -1, bool italic = false)
Crée un objet police avec les paramètres spécifiés pour ` family`, ` pointSize`, ` weight ` et ` italic `.
Si pointSize est égal à zéro ou à une valeur négative, la taille en points de la police est définie sur une valeur par défaut propre au système. En général, cette valeur est de 12 points.
Le nom de la police ( family ) peut également inclure, de manière facultative, le nom d’un éditeur, par exemple « Helvetica [Cronyx] ». Si la police ( family ) est disponible auprès de plusieurs éditeurs et que l’éditeur n’est pas spécifié, un éditeur est choisi de manière aléatoire. Si la famille n’est pas disponible, une famille sera définie à l’aide de l’algorithme font matching.
Cette méthode divise la chaîne de la famille au niveau de la virgule et appelle setFamilies() avec la liste obtenue. Pour conserver une police dont le nom contient une virgule, utilisez le constructeur qui prend un QStringList.
Voir également 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)
Crée un objet police avec les paramètres spécifiés suivants : ` families`, ` pointSize`, ` weight ` et ` italic `.
Si pointSize est égal à zéro ou à une valeur négative, la taille en points de la police est définie sur une valeur par défaut propre au système. En général, cette valeur est de 12 points.
Chaque entrée de nom de famille dans ` families ` peut également inclure, de manière facultative, le nom d’un éditeur de polices, par exemple « Helvetica [Cronyx] ». Si la famille est disponible auprès de plusieurs fonderies et que la fonderie n’est pas spécifiée, une fonderie est choisie de manière aléatoire. Si la famille n’est pas disponible, une famille sera définie à l’aide de l’algorithme font matching.
Voir également Weight, setPointSize(), setWeight(), setItalic(), setStyleHint(), setFamilies() et QGuiApplication::font().
QFont::QFont(const QFont &font)
Crée une police qui est une copie de font.
[constexpr noexcept default] QFont::QFont(QFont &&)
Crée par « move » une instance de ` QFont`.
[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 également weight(), setBold() et QFontInfo::bold().
QFont::Capitalization QFont::capitalization() const
Renvoie le type de majuscules actuel de la police.
Voir aussi setCapitalization().
[since 6.7] void QFont::clearFeatures()
Efface toutes les caractéristiques précédemment définies sur l'QFont.
Voir setFeature() pour plus de détails sur les caractéristiques des polices.
Cette fonction a été introduite dans Qt 6.7.
Voir également 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 l'QFont.
Voir setVariableAxis() pour plus de détails sur les axes variables.
Cette fonction a été introduite dans Qt 6.7.
Voir également QFont::Tag, setVariableAxis(), unsetVariableAxis(), isVariableAxisSet() et variableAxisValue().
QString QFont::defaultFamily() const
Renvoie le nom de famille correspondant à l'indication de style actuelle.
Voir également StyleHint, styleHint() et setStyleHint().
bool QFont::exactMatch() const
Renvoie « true » si une police du système de fenêtrage correspondant exactement aux paramètres de cette police est disponible.
Voir également 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, elle renvoie une liste vide.
Voir également setFamily(), setFamilies(), family(), substitutes() et substitute().
QString QFont::family() const
Renvoie le nom de la famille de polices demandée. Ce nom correspondra toujours à la première entrée de l'appel à la fonction families().
Voir également setFamily(), substitutes(), substitute(), setFamilies() et families().
[since 6.7] QList<QFont::Tag> QFont::featureTags() const
Renvoie une liste des balises correspondant à toutes les caractéristiques de police actuellement définies sur cet objet ` QFont`.
Voir setFeature() pour plus de détails sur les caractéristiques de police.
Cette fonction a été introduite dans Qt 6.7.
Voir également QFont::Tag, setFeature(), unsetFeature(), isFeatureSet() et clearFeatures().
[since 6.7] quint32 QFont::featureValue(QFont::Tag tag) const
Renvoie la valeur définie pour une fonctionnalité spécifique tag. Si la balise n'a pas été définie, la valeur 0 est renvoyée à la place.
Voir setFeature() pour plus de détails sur les fonctionnalités des polices.
Cette fonction a été introduite dans Qt 6.7.
Voir également 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 également setFixedPitch() et QFontInfo::fixedPitch().
bool QFont::fromString(const QString &descrip)
Définit cette police pour qu'elle corresponde à la description descrip. La description est une liste d'attributs de police séparés par des virgules, telle qu'elle est renvoyée par la fonction toString().
Voir également toString().
QFont::HintingPreference QFont::hintingPreference() const
Renvoie le niveau d'hinting actuellement privilégié pour les glyphes affichés avec cette police.
Voir également 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 celle-ci en détruisant puis en recréant tous les objets ` QFont `.
Voir également 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 remplacé une police, déclenchez la mise à jour de celle-ci en détruisant puis en recréant tous les objets QFont.
Voir également 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 si l'une d'elles a été créée à partir de l'autre et qu'aucune n'a été modifiée depuis. Cette condition est beaucoup plus stricte que la simple égalité.
Voir également operator=() et operator==().
[since 6.7] bool QFont::isFeatureSet(QFont::Tag tag) const
Renvoie « true » si une valeur pour la fonctionnalité indiquée par tag a été définie sur QFont; sinon, renvoie « false ».
Voir setFeature() pour plus de détails sur les caractéristiques des polices.
Cette fonction a été introduite dans Qt 6.7.
Voir également QFont::Tag, setFeature(), unsetFeature(), featureTags() et featureValue().
[since 6.7] bool QFont::isVariableAxisSet(QFont::Tag tag) const
Renvoie « true » si une valeur pour l'axe de variable spécifié par tag a été définie sur l'QFont; sinon, renvoie « false ».
Voir setVariableAxis() pour plus de détails sur les axes variables des polices.
Cette fonction a été introduite dans Qt 6.7.
Voir également QFont::Tag, setVariableAxis(), unsetVariableAxis(), variableAxisValue() et clearVariableAxes().
bool QFont::italic() const
Renvoie « true » si la méthode style() de la police ne renvoie pas QFont::StyleNormal
Voir également setItalic() et style().
bool QFont::kerning() const
Renvoie « true » si le crénage doit être utilisé lors de l'affichage du texte avec cette police.
Voir aussi setKerning().
QString QFont::key() const
Renvoie la clé de la police, c'est-à-dire une représentation textuelle de celle-ci. 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 entre les lettres de la police.
Voir également setLetterSpacing(), letterSpacingType() et setWordSpacing().
QFont::SpacingType QFont::letterSpacingType() const
Renvoie le type d'espacement utilisé pour l'espacement des lettres.
Voir également letterSpacing(), setLetterSpacing() et setWordSpacing().
bool QFont::overline() const
Renvoie « true » si l’option « overline » a été définie ; sinon, renvoie « false ».
Voir également setOverline().
int QFont::pixelSize() const
Renvoie la taille en pixels de la police si celle-ci a été définie à l'aide de la fonction ` setPixelSize()`. Renvoie -1 si la taille a été définie à l'aide de la fonction ` setPointSize()` ou ` setPointSizeF()`.
Voir également setPixelSize(), pointSize(), QFontInfo::pointSize() et QFontInfo::pixelSize().
int QFont::pointSize() const
Renvoie la taille en points de la police. Renvoie -1 si la taille de la police a été spécifiée en pixels.
Voir également setPointSize() et pointSizeF().
qreal QFont::pointSizeF() const
Renvoie la taille en points de la police. Renvoie -1 si la taille de la police a été spécifiée en pixels.
Voir également pointSize(), setPointSizeF(), pixelSize(), QFontInfo::pointSize() et QFontInfo::pixelSize().
[static] void QFont::removeSubstitutions(const QString &familyName)
Supprime toutes les substitutions pour familyName.
Voir également insertSubstitutions(), insertSubstitution(), substitutions() et substitute().
QFont QFont::resolve(const QFont &other) const
Renvoie un nouvel objet ` QFont ` dont les attributs sont copiés depuis ` other ` et qui n'ont pas encore été définis pour cette police.
void QFont::setBold(bool enable)
Si enable est vrai, l'épaisseur de la police est définie sur QFont::Bold; sinon, elle est définie sur QFont::Normal.
Pour un contrôle plus précis de l'épaisseur, utilisez ` setWeight()`.
Remarque : si styleName() est défini, cette valeur peut être ignorée ou, si la plate-forme le prend en charge, la police peut être artificiellement mise en gras.
Voir également bold() et setWeight().
void QFont::setCapitalization(QFont::Capitalization caps)
Définit la casse du texte dans cette police sur « caps ».
La capitalisation d'une police fait apparaître le texte selon le mode de capitalisation sélectionné.
Voir également capitalization().
void QFont::setFamilies(const QStringList &families)
Définit la liste des noms de familles pour la police. Les noms ne sont pas sensibles à la casse et peuvent inclure le nom d’un éditeur de polices. La première famille répertoriée dans families sera définie comme famille principale pour la police.
Chaque entrée de nom de famille dans ` families ` peut également inclure, de manière facultative, le nom d’une fonderie, par exemple « Helvetica [Cronyx] ». Si la famille est disponible auprès de plusieurs fonderies et que la fonderie n’est pas spécifiée, une fonderie est choisie de manière aléatoire. Si la famille n’est pas disponible, une famille sera définie à l’aide de l’algorithme font matching.
Voir également family(), families(), setFamily(), setStyleHint() et QFontInfo.
void QFont::setFamily(const QString &family)
Définit le nom de la famille de polices. Le nom n'est pas sensible à la casse et peut inclure le nom d'un éditeur de polices.
Le nom de la famille de polices ( family ) peut également inclure, de manière facultative, le nom d’un éditeur, par exemple « Helvetica [Cronyx] ». Si la famille de polices ( family ) est disponible auprès de plusieurs éditeurs et que l’éditeur n’est pas spécifié, un éditeur est choisi de manière aléatoire. Si la famille n’est pas disponible, une famille sera définie à l’aide de l’algorithme de sélection de famille de polices ( font matching ).
Voir également 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 offre 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 une « tag », qui est généralement encodée à partir du nom de caractéristique à quatre caractères figurant dans la carte des caractéristiques de la police.
Cet « value » entier 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, tandis qu’une valeur non nulle signifie qu’elle est activée. Pour certaines fonctionnalités de police, cependant, il peut avoir d’autres interprétations. Par exemple, lorsqu’il est appliqué à la fonctionnalité « salt », la valeur est un index qui spécifie l’alternative stylistique à utiliser.
Par exemple, la fonctionnalité de police « frac » convertira les fractions diagonales séparées par une barre oblique (telles que « 1/2 ») en une représentation différente. En général, cela implique de regrouper la fraction complète dans un seul caractère (tel que « ½ »).
Si une police prend en charge la fonctionnalité « frac », celle-ci peut être activée dans le shaper en définissant features["frac"] = 1 dans la carte des fonctionnalités de police.
Remarque : par défaut, Qt active et désactive certaines fonctionnalités de police en fonction d’autres propriétés de police. En particulier, la fonctionnalité « kern » sera activée ou désactivée en fonction de la propriété « kerning() » de l’objet « QFont ». De plus, toutes les fonctionnalités de ligature (liga, clig, dlig, hlig) seront désactivées si un « letterSpacing() » est appliqué, mais uniquement pour les systèmes d’écriture où l’utilisation des ligatures est purement esthétique. Pour les systèmes d’écriture où les ligatures sont obligatoires, ces fonctionnalités conserveront leur état par défaut. Les valeurs définies à l’aide de setFeature() et des fonctions associées remplaceront le comportement par défaut. Si, par exemple, la fonctionnalité « kern » est définie sur 1, le crénage sera toujours activé, même si la propriété de crénage est définie sur false. De même, si elle est définie sur 0, il sera toujours désactivé. Pour rétablir le comportement par défaut d’une fonctionnalité de police, vous pouvez la désactiver à l’aide de la fonction ` unsetFeature()`.
Cette fonction a été introduite dans Qt 6.7.
Voir également QFont::Tag, clearFeatures(), unsetFeature() et featureTags().
void QFont::setFixedPitch(bool enable)
Si enable est vrai, active la hauteur fixe ; sinon, la désactive.
Voir également fixedPitch() et QFontInfo.
void QFont::setHintingPreference(QFont::HintingPreference hintingPreference)
Définissez le niveau de hinting des glyphes sur « hintingPreference ». Il s'agit d'une indication donnée au système de rendu de police sous-jacent afin qu'il utilise un certain niveau de hinting ; la prise en charge varie selon les plateformes. Consultez le tableau figurant dans la documentation relative à QFont::HintingPreference pour plus de détails.
La préférence de hinting par défaut est QFont::PreferDefaultHinting.
Voir également hintingPreference().
void QFont::setItalic(bool enable)
Définit la propriété « style() » de la police sur « QFont::StyleItalic » si « enable » est vrai ; sinon, le style est défini sur « QFont::StyleNormal ».
Remarque : si styleName() est défini, cette valeur peut être ignorée ; ou, si la plate-forme le prend en charge, la police peut être affichée en incliné au lieu d’utiliser une variante de police italique prévue à cet effet.
Voir également italic() et QFontInfo.
void QFont::setKerning(bool enable)
Active le crénage pour cette police si la valeur de « enable » est « true » ; sinon, il 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 le texte latin. En d'autres termes, l'hypothèse selon laquelle width('a') + width('b') est égal à width("ab") n'est pas nécessairement vraie.
Voir également 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, selon le type d'espacement sélectionné.
Voir également letterSpacing(), letterSpacingType() et setWordSpacing().
void QFont::setOverline(bool enable)
Si enable est vrai, active la surligne ; sinon, la désactive.
Voir également overline() et QFontInfo.
void QFont::setPixelSize(int pixelSize)
Définit la taille de la police à pixelSize pixels, la taille maximale étant limitée à 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 de manière indépendante du périphérique.
Voir également ` pixelSize()`.
void QFont::setPointSize(int pointSize)
Définit la taille en points sur pointSize. La taille en points doit être supérieure à zéro.
Voir également pointSize() et setPointSizeF().
void QFont::setPointSizeF(qreal pointSize)
Définit la taille en points sur pointSize. La taille en points doit être supérieure à zéro. La précision demandée peut ne pas être atteinte sur toutes les plateformes.
Voir également 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 d'factor. Par exemple, définir factor sur 150 a pour effet de multiplier par 1,5 (soit 150 %) la largeur de tous les caractères de la police. Le facteur d'étirement minimum est 1 et le facteur d'étirement maximum est 4 000. Le facteur d'étirement par défaut est AnyStretch, ce qui permet d'accepter n'importe quel facteur d'étirement sans appliquer de transformation à la police.
Le facteur d'étirement s'applique uniquement aux polices vectorielles. Il est ignoré pour les polices matricielles.
Remarque : lorsque vous associez une police dont le facteur d’étirement natif n’est pas celui par défaut, demander un étirement de 100 la ramènera à une largeur moyenne.
Voir également stretch() et QFont::Stretch.
void QFont::setStrikeOut(bool enable)
Si enable est vrai, active la mise en gras ; sinon, la désactive.
Voir également strikeOut() et QFontInfo.
void QFont::setStyle(QFont::Style style)
Définit le style de la police sur « style ».
Voir également style(), italic() et QFontInfo.
void QFont::setStyleHint(QFont::StyleHint hint, QFont::StyleStrategy strategy = PreferDefault)
Définit respectivement l'indication de style et la stratégie de style sur « hint » et « strategy ».
Si ces paramètres ne sont pas définis explicitement, la suggestion de style prendra par défaut la valeur AnyStyle et la stratégie de style celle de PreferDefault.
Qt ne prend pas en charge les indications de style sur X11, car ces informations ne sont pas fournies par le système de fenêtrage.
Voir également StyleHint, styleHint(), StyleStrategy, styleStrategy() et QFontInfo.
void QFont::setStyleName(const QString &styleName)
Définit le nom de style de la police sur « styleName ». Une fois cette option activée, les autres propriétés de style telles que « style() » et « weight() » seront ignorées lors de la correspondance des polices, bien qu’elles puissent être simulées par la suite si le moteur de polices de la plateforme le prend en charge.
En raison de la qualité inférieure des styles simulés artificiellement et de l’absence de prise en charge multiplateforme complète, il n’est pas recommandé d’utiliser la correspondance par nom de style en combinaison avec la correspondance par propriétés de style
Voir également ` styleName()`.
void QFont::setStyleStrategy(QFont::StyleStrategy s)
Définit la stratégie de style de la police sur « s ».
Voir également styleStrategy() et QFont::StyleStrategy.
void QFont::setUnderline(bool enable)
Si enable est vrai, active le soulignement ; sinon, le désactive.
Voir également underline() et QFontInfo.
[since 6.7] void QFont::setVariableAxis(QFont::Tag tag, float value)
Applique une valeur « value » à l’axe variable correspondant à « tag ».
Les polices variables permettent de stocker plusieurs variantes (avec différentes épaisseurs, largeurs ou styles) dans un même fichier de police. Les variantes sont représentées par des valeurs à virgule flottante pour un ensemble prédéfini de paramètres, appelés « axes variables ». Les instances spécifiques sont généralement nommées par le créateur de la police et, dans Qt, 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 comporte une sous-famille « Regular » et une sous-famille « Bold », vous pouvez souhaiter obtenir une épaisseur intermédiaire entre les deux. Vous pouvez alors en faire la demande 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 à l’épaisseur 550,0 sera fournie.
Il existe quelques axes standard proposés par de nombreuses polices, tels que « wght » (épaisseur), « wdth » (largeur), « ital » (italique) et « opsz » (taille optique). Chacun d’entre eux dispose d’une plage de valeurs définie dans la police elle-même. Par exemple, « wght » peut aller de 100 à 900 (QFont::Thin à QFont::Black), tandis que « ital » peut aller de 0 à 1 (de non italique à entièrement italique).
Une police peut également choisir de définir des axes personnalisés ; la seule contrainte est que le nom doit respecter les exigences d’une QFont::Tag (séquence de quatre caractères Latin-1).
Par défaut, aucun axe variable n’est défini.
Remarque : sous Windows, les axes variables ne sont pas pris en charge si le backend de police GDI optionnel est utilisé.
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 sur « weight », en utilisant l'échelle définie par l'énumération « QFont::Weight ».
Remarque : si la fonction ` styleName()` est définie, cette valeur peut être ignorée lors de la sélection de la police.
Voir également weight() et QFontInfo.
void QFont::setWordSpacing(qreal spacing)
Définit l'espacement entre les mots de la police sur « spacing ».
L'espacement entre les mots modifie l'espacement par défaut entre les mots. Une valeur positive augmente l'espacement entre les mots d'un nombre correspondant de pixels, tandis qu'une valeur négative le réduit d'autant.
L'espacement entre les mots ne s'applique pas aux systèmes d'écriture dans lesquels les mots ne sont pas séparés par des espaces.
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 la fonction « strikeout » a été définie ; 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'StyleHint.
L'indication de style affecte l'font matching algorithm. Consultez QFont::StyleHint pour obtenir la liste des indications disponibles.
Voir également setStyleHint(), QFont::StyleStrategy et QFontInfo::styleHint().
QString QFont::styleName() const
Renvoie le nom du style de police demandé. Cette fonction peut être utilisée pour faire correspondre la police à des styles irréguliers (qui ne peuvent pas être normalisés dans d'autres propriétés de style).
Voir également setStyleName(), setFamily() et setStyle().
QFont::StyleStrategy QFont::styleStrategy() const
Renvoie l'StyleStrategy.
La stratégie de style influe sur l’algorithme de l’ font matching. Consultez QFont::StyleStrategy pour obtenir la liste des stratégies disponibles.
Voir également 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 ne tient pas compte de la casse.
S'il n'y a pas de substitution pour « familyName », la valeur « familyName » est renvoyée.
Pour obtenir la liste des substitutions, utilisez ` substitutes()`.
Voir également setFamily(), insertSubstitutions(), insertSubstitution() et removeSubstitutions().
[static] QStringList QFont::substitutes(const QString &familyName)
Renvoie une liste de noms de famille à utiliser chaque fois que la fonction ` familyName ` est appelée. La recherche ne tient pas compte de la casse.
S’il n’y a pas de substitution pour ` familyName`, une liste vide est renvoyée.
Voir également substitute(), insertSubstitutions(), insertSubstitution() et removeSubstitutions().
[static] QStringList QFont::substitutions()
Renvoie une liste triée des noms de famille ayant fait l'objet d'une substitution.
Voir également 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 ne rencontre jamais d'échec.
QString QFont::toString() const
Renvoie une description de la police. Cette 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 polices
- Taille en points
- Taille en pixels
- Indication de style
- Épaisseur de la police
- Style de police
- Souligné
- Barré
- Espacement 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 l'option « underline » a été activée ; sinon, renvoie « false ».
Voir également setUnderline().
[since 6.7] void QFont::unsetFeature(QFont::Tag tag)
Supprime la caractéristique « tag » de la carte des caractéristiques explicitement activées/désactivées.
Remarque : même si la fonctionnalité n’a pas été ajoutée auparavant, cette opération marquera la carte des fonctionnalités de police comme modifiée dans cette QFont, de sorte qu’elle aura la priorité lors de la résolution par rapport à d’autres polices.
La désactivation d’une fonctionnalité existante dans l’ QFont rétablit le comportement par défaut.
Voir setFeature() pour plus de détails sur les fonctionnalités de police.
Cette fonction a été introduite dans Qt 6.7.
Voir également QFont::Tag, clearFeatures(), setFeature(), featureTags() et featureValue().
[since 6.7] void QFont::unsetVariableAxis(QFont::Tag tag)
Annule la valeur d'un axe variable précédemment définie par tag.
Remarque : si aucune valeur n'a été spécifiée auparavant pour cette balise, l'QFont considérera tout de même que ses axes variables sont définis lors de la résolution par rapport à d'autres valeurs d'QFont.
Cette fonction a été introduite dans Qt 6.7.
Voir également setVariableAxis.
[since 6.7] QList<QFont::Tag> QFont::variableAxisTags() const
Renvoie une liste des balises correspondant à tous les axes variables actuellement définis sur cette page QFont.
Voir setVariableAxis() pour plus de détails sur les axes variables.
Cette fonction a été introduite dans Qt 6.7.
Voir également 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 de variable spécifique tag. Si la balise n'a pas été définie, la valeur 0,0 est renvoyée à la place.
Voir setVariableAxis() pour plus de détails sur les axes variables.
Cette fonction a été introduite dans Qt 6.7.
Voir également QFont::Tag, setVariableAxis(), unsetVariableAxis(), isVariableAxisSet() et clearVariableAxes().
QFont::Weight QFont::weight() const
Renvoie l'épaisseur de la police, en utilisant la même échelle que l'énumération QFont::Weight.
Voir également setWeight(), Weight et QFontInfo.
qreal QFont::wordSpacing() const
Renvoie l'espacement entre les mots pour la police.
Voir également setWordSpacing() et setLetterSpacing().
QFont::operator QVariant() const
Renvoie la police sous la forme d'un QVariant
bool QFont::operator!=(const QFont &f) const
Renvoie « true » si cette police est différente de « f » ; sinon, renvoie « false ».
Deux objets QFont sont considérés comme différents 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. La seule garantie est que l'opérateur renvoie « false » si les deux polices sont identiques, et « (f1 < f2) == !(f2 < f1) » si elles ne le sont pas.
Cette fonction est utile dans certaines circonstances, par exemple si vous souhaitez utiliser des objets ` QFont ` comme clés dans un ` QMap`.
Voir également operator==(), operator!=() et isCopyOf().
[noexcept] QFont &QFont::operator=(QFont &&other)
Cette opération attribue l'other à cette instance QFont.
QFont &QFont::operator=(const QFont &font)
Attribue la propriété « font » à cette police et renvoie une référence à celle-ci.
bool QFont::operator==(const QFont &f) const
Renvoie « true » si cette police est identique à « f » ; sinon, renvoie « false ».
Deux objets `QFont` sont considérés comme égaux si leurs attributs de police sont identiques.
Voir également operator!=() et isCopyOf().
Éléments non membres associés
[noexcept] size_t qHash(const QFont &key, size_t seed = 0)
Renvoie la valeur de hachage de key, en utilisant seed comme graine pour le calcul.
QDataStream &operator<<(QDataStream &s, const QFont &font)
Écrit la chaîne « font » dans le flux de données « s ». (La fonction «toString() » écrit dans un flux de texte.)
Voir également Format des opérateurs QDataStream.
QDataStream &operator>>(QDataStream &s, QFont &font)
Lit la police font à partir du flux de données s. (La fonctionfromString() lit à partir d'un flux de texte.)
Voir également 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.