Auf dieser Seite

FontLoader QML Type

Ermöglicht das Laden von Schriftarten über eine URL. Mehr...

Import Statement: import QtQuick

Eigenschaften

Ausführliche Beschreibung

Der Typ „FontLoader“ wird zum Laden von Schriftarten über eine URL verwendet.

Die Eigenschaft „ status “ gibt an, wann die Schriftart geladen wurde, was insbesondere bei Schriftarten nützlich ist, die von entfernten Quellen geladen werden.

Beispiel:

import QtQuick 2.0

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

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

Siehe auch Beispiele für „Qt Quick “ – Text-Schriftarten.

Dokumentation zu den Eigenschaften

font : font [read-only, since 6.0]

Diese Eigenschaft enthält eine Standardabfrage für die geladene Schriftart.

Sie können diese verwenden, um die Schriftart auszuwählen, wenn zur Eindeutigkeit andere Eigenschaften als nur der Familienname benötigt werden. Sie können die Schriftart entweder über einzelne Eigenschaften angeben:

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
    }
}

Oder Sie können die vollständige Schriftartabfrage direkt festlegen:

Item {
    width: 200; height: 50

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

In diesem Fall wird die Standard-Schriftartabfrage unverändert verwendet (so entspricht beispielsweise die Schriftgröße dem Systemstandard).

Diese Eigenschaft wurde in Qt 6.0 eingeführt.

name : string [read-only]

Diese Eigenschaft enthält den Namen der Schriftfamilie. Sie wird automatisch gesetzt, wenn eine Schriftart über die Eigenschaft „ source “ geladen wird.

Dies entspricht der Eigenschaft „family“ der Eigenschaft „ font “ von „ FontLoader “.

Verwenden Sie diese Eigenschaft, um die Eigenschaft „ font.family “ eines „ Text “-Elements festzulegen.

Beispiel:

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

Die URL der Schriftart, die geladen werden soll.

status : enumeration [read-only]

Diese Eigenschaft gibt den Status des Ladens der Schriftart an. Mögliche Werte sind:

KonstanteBeschreibung
FontLoader.NullEs wurde keine Schriftart festgelegt
FontLoader.ReadyDie Schriftart wurde geladen
FontLoader.LoadingDie Schriftart wird gerade geladen
FontLoader.ErrorBeim Laden der Schriftart ist ein Fehler aufgetreten

Verwenden Sie diesen Status, um eine Aktualisierung bereitzustellen oder auf die Statusänderung in irgendeiner Weise zu reagieren. Sie könnten beispielsweise:

  • Eine Statusänderung auslösen:
    State { name: 'loaded'; when: loader.status == FontLoader.Ready }
  • Implementieren Sie einen Signal-Handler für „ onStatusChanged “:
    FontLoader {
        id: loader
        onStatusChanged: if (loader.status == FontLoader.Ready) console.log('Loaded')
    }
  • Eine Bindung an den Statuswert herstellen:
    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.