Sur cette page

FontLoader QML Type

Permet de charger des polices par URL. Plus d'informations...

Import Statement: import QtQuick

Propriétés

Description détaillée

Le type FontLoader est utilisé pour charger des polices par URL.

L'adresse status indique que la police a été chargée, ce qui est utile pour les polices chargées à partir de sources distantes.

C'est utile pour les polices chargées à partir de sources distantes :

import QtQuick 2.0

Column {
    FontLoader { id: webFont; source: "http://www.mysite.com/myfont.ttf" }

    Text { text: "Fancy font"; font: webFont.font }
}

Voir également Qt Quick Exemples - Polices de texte.

Documentation sur les propriétés

font : font [read-only, since 6.0]

Cette propriété contient une requête par défaut pour la police chargée.

Vous pouvez l'utiliser pour sélectionner la police si d'autres propriétés que le nom de famille sont nécessaires pour la désambiguïser. Vous pouvez spécifier la police en utilisant des propriétés individuelles :

Item {
    width: 200; height: 50

    FontLoader {
        id: webFont
        source: "http://www.mysite.com/myfont.ttf"
    }
    Text {
        text: "Fancy font"
        font.family: webFont.font.family
        font.weight: webFont.font.weight
        font.styleName: webFont.font.styleName
        font.pixelSize: 24
    }
}

soit définir directement la requête complète de la police :

Item {
    width: 200; height: 50

    FontLoader {
        id: webFont
        source: "http://www.mysite.com/myfont.ttf"
    }
    Text {
        text: "Fancy font"
        font: webFont.font
    }
}

Dans ce cas, la requête de police par défaut sera utilisée sans aucune modification (la taille de la police, par exemple, sera la valeur par défaut du système).

Cette propriété a été introduite dans Qt 6.0.

name : string [read-only]

Cette propriété contient le nom de la famille de polices. Elle est définie automatiquement lorsqu'une police est chargée à l'aide de la propriété source.

Elle est équivalente à la propriété family de la propriété font de FontLoader.

Utilisez cette propriété pour définir la propriété font.family d'un élément Text.

Exemple :

Item {
    width: 200; height: 50

    FontLoader {
        id: webFont
        source: "http://www.mysite.com/myfont.ttf"
    }
    Text {
        text: "Fancy font"
        font.family: webFont.name
    }
}

source : url

L'URL de la police à charger.

status : enumeration [read-only]

Cette propriété indique l'état de chargement des polices. Elle peut être l'une des suivantes

ConstanteDescription
FontLoader.Nullaucune police n'a été définie
FontLoader.Readyla police a été chargée
FontLoader.Loadingla police est en cours de chargement
FontLoader.Errorune erreur s'est produite lors du chargement de la police

Utilisez cet état pour fournir une mise à jour ou répondre au changement d'état d'une manière ou d'une autre. Par exemple, vous pouvez

  • déclencher un changement d'état :
    State { name: 'loaded'; when: loader.status == FontLoader.Ready }
  • implémenter un gestionnaire de signal onStatusChanged:
    FontLoader {
        id: loader
        onStatusChanged: if (loader.status == FontLoader.Ready) console.log('Loaded')
    }
  • se lier à la valeur de l'état :
    Text { text: loader.status == FontLoader.Ready ? 'Loaded' : 'Not loaded' }

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