FontLoader QML Type

Permet de charger des polices via une URL. En savoir plus...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• font : font (since 6.0)
• name : string
• source : url
• status : enumeration

Description détaillée

Le type FontLoader sert à charger des polices à partir d'une URL.

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

Par exemple :

import QtQuick 2.0

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

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

Voir également Exemples d'Qt Quick - 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 la famille sont nécessaires pour lever toute ambiguïté. Vous pouvez soit spécifier la police à l’aide de 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 de police complète :

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 modification (la taille de la police, par exemple, sera donc celle définie par défaut par le 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.

Cela équivaut à la propriété « family » de la propriété « font » de l’ FontLoader.

Utilisez-la 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 du chargement de la police. Elle peut prendre l'une des valeurs suivantes :

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

• 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')
  }

• Lier la valeur du statut :

  Text { text: loader.status == FontLoader.Ready ? 'Loaded' : 'Not loaded' }