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:
| Konstante | Beschreibung |
|---|---|
FontLoader.Null | Es wurde keine Schriftart festgelegt |
FontLoader.Ready | Die Schriftart wurde geladen |
FontLoader.Loading | Die Schriftart wird gerade geladen |
FontLoader.Error | Beim 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.